BlockchainTokenData

BlockchainTokenData["name"]

gives information about the use of tokens with the specified name on a blockchain.

BlockchainTokenData["sym"]

gives information about tokens with symbol sym.

BlockchainTokenData["address"]

gives information about tokens associated with the specified address.

BlockchainTokenData[assoc]

gives information about tokens with properties matching the specification in assoc.

BlockchainTokenData[tokenspec,prop]

gives the specified property of token usage.

Details and Options

  • In BlockchainTokenData["name"], name can either be the name assigned to a specific token (e.g. "Tronix") or the standard for a class of tokens (e.g. "ERC721").
  • The tokenspec input refers to any input, whether it is a String name or an Association assoc.
  • In BlockchainTokenData[assoc], the association assoc can have elements with the following keys:
  • "Name"name of the token (e.g. "Tronix")
    "Symbol"symbol for the token (e.g. "CK")
    "TokenAddress"address associated with the token
    "TokenStandard"standard defining the token (e.g. "ERC20")
    "TimeInterval"time interval for transactions to be included
    "BlockNumberInterval"blocks whose transactions should be included
    "Addresses"sender or receiver addresses for transactions
    "SenderAddresses"sender addresses for transactions
    "ReceiverAddresses"receiver addresses for transactions
    "HolderAddresses"addresses of current token holders
  • Any key that is omitted is assumed to allow any value. This can also be specified using "key"->All.
  • The "TimeInterval" can be given as a single DateObject with a specified granularity, or as a list of start-and-end-date objects.
  • Possible options for BlockchainTokenData include:
  • BlockchainBase"Ethereum"the blockchain and network to use
    MaxItems20the maximum number of individual results to return
  • BlockchainTokenData gives a list of associations, with each association giving the results for a single token.
  • The setting for MaxItems specifies the maximum number of holders, transfers, sender addresses and receiver addresses to include in each result.
  • BlockchainTokenData[tokenspec] by default gives associations with the following elements:
  • "Name"name of the token
    "Symbol"symbol for the token
    "TokenAddress"address associated with the token
    "TokenStandard"standard defining the token
    "TotalSupply"total existing supply of the token
    "HoldersCount"total current holders of the token
    "TransfersCount"total transfers that have been made of the token
    "AddressesCount"total addresses that have received the token
  • BlockchainTokenData[tokenspec,prop] also supports the following additional properties:
  • "HolderList"current token holders, with the largest holders first
    "TransferList"transfers of the token, with the most recent first
    "SenderAddressList"addresses of all senders of the token
    "ReceiverAddressList"addresses of all receivers of the token
  • Properties supported for specific token types include:
  • "TransferPrecision"number of precision digits for each transfer ("ERC20")
    "HolderTokenIDs"list of token IDs held by current holders ("ERC721")
  • BlockchainTokenData[tokenspec,{prop1,prop2,}] includes the propi in each association.
  • The value for "HolderList" is a list of associations with the following keys:
  • "HolderAddress"address of the holder
    "Balance"balance of the holder
    "BalanceFraction"fraction of the total supply held by the holder
  • The value for "TransferList" is a list of associations with the following keys:
  • "Name"name of the token
    "TokenAddress"address associated with the token
    "TransactionID"transaction hash, which includes the token transfer
    "BlockNumber"block number including the transaction
    "Time"timestamp of the block
    "Sender"sender of the token
    "Receiver"receiver of the token
    "Amount"amount of tokens sent (only for "ERC20")
    "TokenID"ID of token sent (only for "ERC721")

Examples

open all close all

Basic Examples  (4)

Check specific token information by name:

In[1]:=
Click for copyable input
Out[1]=

Check specific token information by symbol:

In[1]:=
Click for copyable input
Out[1]=

Check specific token information by token address:

In[1]:=
Click for copyable input
Out[1]=

List all "ERC20" tokens:

In[1]:=
Click for copyable input
Out[1]=

Scope  (9)

Options  (2)

Properties & Relations  (1)

Introduced in 2019
(12.0)