BlockchainTokenData (for Tezos)

BlockchainTokenData["name"]

gives general information about the use of tokens with the specified name on the Tezos 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. "Aspen Digital") or the standard for a class of tokens (e.g. "FA1").
  • 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:
  • "TokenID"ID for token (only for "FA2")
    "Name"name of the token (e.g. "Aspen Digital")
    "Symbol"symbol for the token (e.g. "TZBTC")
    "TokenAddress"address associated with the token
    "TokenStandard"standard defining the token (e.g. "FA2")
    "TimeInterval"time interval for transactions to be included
    "BlockNumberInterval"blocks whose transactions should be included
    "Addresses"sender or 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 "Tezos"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 that match tokenspec as a list of associations sorted by "TransfersCount" with the following properties:
  • "TokenID"ID for token (only for "FA2")
    "Name"name of the token
    "Symbol"symbol for the token
    "TokenAlias"alias of the address associatied with 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
    "TransfersCount"total transfers that have been made of the token
    "TotalTransferred"total amount of tokens transferred
  • When the element "HolderAddresses" is given in the input association assoc, BlockchainTokenData[assoc] returns a list of associations sorted by "BalanceFraction" with the following properties:
  • "Name"name of the token
    "Symbol"symbol for the token
    "TokenAlias"alias of the address associated with 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
    "BalanceFraction"fraction of the total supply held by the holder
  • When the elements "TimeInterval", "BlockNumberInterval" or "Addresses" are given in the input association assoc, BlockchainTokenData[assoc] returns a list of associations sorted by "Timestamp" with the following properties:
  • "Name"name of the token
    "TokenStandard"standard defining the token
    "TransactionID"transaction hash, which includes the token transfer
    "BlockNumber"block number including the transaction
    "Timestamp" timestamp of the block
    "Sender"sender of the token
    "Receiver"receiver of the token
    "TokenID"ID for token (only for "FA2")
    "Amount"amount of tokens sent
  • 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" or "Addresses" 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 lists of associations sorted by "BalanceFraction" 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 lists of associations sorted by "Timestamp" with the following keys:
  • "TransactionID"transaction hash, which includes the token transfer
    "BlockNumber"block number including the transaction
    "Timestamp" timestamp of the block
    "Sender"sender of the token
    "Receiver"receiver of the token
    "TokenID"ID of token sent (only for "FA2")
    "Amount"amount of tokens sentEsc
  • BlockchainTokenData[tokenspec,{prop1,prop2,}] includes the propi in each association.

Examples

open allclose all

Basic Examples  (16)

Check specific token information by name:

Check specific token information by symbol:

Check specific token information by token contract alias:

Check specific token information by token address:

List all "FA1.2" tokens:

List all tokens:

Get total existing supply of the tzBTC token:

Get multiple properties from the tzBTC token:

Get multiple tokens using their symbol:

Filter token transfers by block:

Filter token transfers by time:

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

Filter all "FA1.2" tokens that a specific holder has kept:

Get information about tokens using the addresses of current holders:

Get 5 current tzBTC token holders:

Filter all token transfers of a specific token ID:

Scope  (26)

Amount  (2)

Get the amount of tokens sent in a time interval:

Get the amount of 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  (2)

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

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

HolderList  (1)

Check the most relevant holders of a specific token:

Name  (1)

Get the name of a token:

Receiver  (2)

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

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

ReceiverAddressList  (1)

Check the last receiver addresses of a specific token:

Sender  (2)

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

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:

Timestamp  (2)

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

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

TokenAddress  (1)

Get a token's address:

TokenStandard  (1)

Get a token's standard:

TotalSupply  (1)

Get a token's total supply:

TotalTransferred  (1)

Get the total amount of tokens transferred:

TransactionID  (2)

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

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 "FA1.2" tokens:

Testnet  (1)

BlockchainTokenData does not list testnet tokens currently:

MaxItems  (1)

List the last 10 transfers for a specific token:

Properties & Relations  (1)

Querying by the name, the symbol or the address of a token gives the same data:

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-Tezos.html.

Text

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

CMS

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

APA

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

BibTeX

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

BibLaTeX

@online{reference.wolfram_2023_blockchaintokendata, organization={Wolfram Research}, title={BlockchainTokenData}, year={2020}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainTokenData-Tezos.html}, note=[Accessed: 29-March-2024 ]}