BlockchainTokenData(for Ethereum)

$BlockchainBase = "Ethereum"

BlockchainTokenData["name"]

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

BlockchainTokenData["sym"]

gives general information about tokens with symbol sym.

BlockchainTokenData["address"]

gives general information about tokens associated with the specified address.

BlockchainTokenData[assoc]

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

BlockchainTokenData[tokenspec,prop]

gives the specified property of token usage.

Details

  • BlockchainTokenData gives a list of associations, with each association giving the results for a single token.
  • 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 transfers
    "SenderAddresses"sender addresses for transfers
    "ReceiverAddresses"receiver addresses for transfers
    "HolderAddresses"addresses of current token holders
  • Any key that is omitted in the input association is assumed to allow any value. This is equivalent to specifying the key and value as "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 items to return
  • The setting for MaxItems specifies the maximum number of holders, transfers, sender addresses and receiver addresses to include in each result.
  • BlockchainTokenData[tokenspec] gives general information about tokens in 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
    "AddressesCount"total addresses that have received the token
    "TransfersCount"total transfers that have been made of the token
  • Properties supported for specific token types include:
  • "TransferPrecision"number of precision digits of the token ("ERC20")
    "HolderTokenIDs"list of token IDs held by current holders ("ERC721")
  • 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
  • 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" time stamp 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")
  • BlockchainTokenData[tokenspec,{prop1,prop2,}] includes the propi in each association.

Examples

open all close all

Basic Examples  (12)

Check specific token information by name:

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

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]=

Get total existing supply of the CryptoKitties token:

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

Get multiple properties from the CryptoKitties token:

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

Filter token transfers by block:

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

Filter token transfers by time:

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

Filter token transfers by a sender address:

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

Filter token transfers by a receiver address:

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

Filter all "ERC20" token transfers by an address, whether it is the sender or the receiver:

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

Filter all "ERC20" tokens that a specific holder has kept:

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

Scope  (14)

Options  (3)

Properties & Relations  (1)

Possible Issues  (1)

Introduced in 2019
(12.1)