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, symbol, address 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
    MaxItems 20the 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 that include 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
    "TransferPrecision"number of precision digits of the token (only for "ERC20")
    "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
  • Additionally, BlockchainTokenData[assoc] returns the following properties when the element "HolderAddresses" is given in the input association assoc:
  • "Name"name of the token
    "Symbol"symbol for the token
    "TokenAddress"address associated with the token
    "TokenStandard"standard defining the token
    "TransfersCount"total transfers that have been made of the token by the given holders
    "Balance"balance of the holder
    "HolderTokenIDs"list of token IDs held by current holders (only for "ERC721")
    "BalanceFraction"fraction of the total supply held by the holder
  • BlockchainTokenData[assoc] returns the following properties when the elements "TimeInterval", "BlockNumberInterval", "Addresses", "SenderAddresses" or "ReceiverAddresses" are given in the input association assoc:
  • "Name"name of the token
    "TokenStandard"standard defining 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")
  • 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
  • These properties are not available when the elements "TimeInterval", "BlockNumberInterval", "Addresses", "SenderAddresses" or "ReceiverAddresses" are given in the input association tokenspec.
  • The property "HolderList" is not available when the element "HolderAddresses" is given in the input association tokenspec.
  • 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:
  • "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")
  • BlockchainTokenData[tokenspec,{prop1,prop2,…}] includes the propi in each association.

Examples

open allclose all

Basic Examples  (13)

Check specific token information by name:

Check specific token information by symbol:

Check specific token information by token address:

List all "ERC20" tokens:

Get total existing supply of the CryptoKitties token:

Get multiple properties from the CryptoKitties token:

Filter token transfers by block:

Filter token transfers by time:

Filter token transfers by a sender address:

Filter token transfers by a receiver address:

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

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

Get 5 current Cryptokitties token holders:

Scope  (51)

AddressesCount  (1)

Get the total addresses that have received a token:

Amount  (5)

Get the amount of ERC-20 tokens sent in a time interval:

Get the amount of ERC-20 tokens sent filtered by a sender address:

Get the amount of ERC-20 tokens sent filtered by a receiver address:

Get the amount of ERC-20 tokens sent in a block interval:

Balance  (1)

Get the balance of a holder address:

BalanceFraction  (1)

Get the fraction of the total supply held by the holder:

BlockNumber  (5)

Get the blocks containing the token transactions in a time interval:

Get the blocks containing the token transactions of a sender address:

Get the blocks containing the token transactions of a receiver address:

Get the blocks containing the token transactions in a block interval:

HolderList  (1)

Check the most relevant holders of a specific token:

HoldersCount  (1)

Get the total current holders of a token:

HolderTokenIDs  (1)

Get the list of token IDs held by current holders:

Name  (1)

Get the name of a token:

Receiver  (5)

Get the receiver of a token filtered by a time interval:

Get the receiver of a token filtered by sender address:

Filtered by receiver address, the "Receiver" property returns the same address:

Get the receiver of a token filtered by a block interval:

ReceiverAddressList  (1)

Check the last receiver addresses of a specific token:

Sender  (5)

Get the sender of a token filtered by a time interval:

Filtered by sender address, the "Sender" property returns the same address:

Get the sender of a token filtered by receiver address:

Get the sender of a token filtered by a block interval:

SenderAddressList  (1)

Check the last sender addresses of a specific token:

Symbol  (1)

Get a token's symbol:

Time  (5)

Get the block timestamp associated to a token filtered by a time interval:

Get the block timestamp associated to a token filtered by sender address:

Get the block timestamp associated to a token filtered by receiver address:

Get the block timestamp associated to a token filtered by a block interval:

TokenAddress  (1)

Get a token's address:

TokenID  (5)

Get the ID of an ERC-721 token sent filtered by a time interval:

Get the ID of an ERC-721 token sent filtered by sender address:

Get the ID of an ERC-721 token sent filtered by receiver address:

Get the ID of an ERC-721 token sent filtered by a block interval:

TokenStandard  (1)

Get a token's standard:

TotalSupply  (1)

Get a token's total supply:

TransactionID  (5)

Get the transaction hash including the token transfer filtered by a time interval:

Get the transaction hash including the token transfer filtered by sender address:

Get the transaction hash including the token transfer filtered by receiver address:

Get the transaction hash including the token transfer filtered by a block interval:

TransferList  (1)

Check the most recent transfers of a specific token:

TransferPrecision  (1)

Get the number of precision digits for a token:

TransfersCount  (1)

Get the total transfers that have been made of a token:

Options  (3)

BlockchainBase  (2)

Mainnet  (1)

List all "ERC721" tokens:

Testnet  (1)

BlockchainTokenData does not list testnet tokens currently:

MaxItems  (1)

List the last 10 transfers for a specific token:

Possible Issues  (1)

Testnet Tokens  (1)

BlockchainTokenData does not list testnet tokens currently:

Neat Examples  (1)

Create a word cloud of tokens based on their usage:

Wolfram Research (2020), BlockchainTokenData, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainTokenData-Ethereum.html.

Text

Wolfram Research (2020), BlockchainTokenData, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainTokenData-Ethereum.html.

CMS

Wolfram Language. 2020. "BlockchainTokenData." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/blockchain/BlockchainTokenData-Ethereum.html.

APA

Wolfram Language. (2020). BlockchainTokenData. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/blockchain/BlockchainTokenData-Ethereum.html

BibTeX

@misc{reference.wolfram_2024_blockchaintokendata, author="Wolfram Research", title="{BlockchainTokenData}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/blockchain/BlockchainTokenData-Ethereum.html}", note=[Accessed: 22-November-2024 ]}

BibLaTeX

@online{reference.wolfram_2024_blockchaintokendata, organization={Wolfram Research}, title={BlockchainTokenData}, year={2020}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainTokenData-Ethereum.html}, note=[Accessed: 22-November-2024 ]}