WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

BlockchainAddressData (for Tezos)

[Experimental]

BlockchainAddressData["address"]

gives available information connected with the specified address on the Tezos blockchain.

BlockchainAddressData[assoc]

gives available information connected with properties matching the specification in assoc.

BlockchainAddressData[addressSpec,prop]

gives the specified property of the Tezos blockchain address.

Details

  • The blockchain address can be specified as follows:
  • "address"address on the Tezos mainnet blockchain
    "chain""address"address on the specified public blockchain
    {"chain","network"}"address"address on a specific network for a Tezos blockchain
  • The addressSpec input refers to any input, whether it is a String address or an Association assoc.
  • In BlockchainAddressData[assoc], the association assoc can have elements with the following keys:
  • "Address"address on the Tezos blockchain
    "TimeInterval"time interval for operations to be included
    "BlockNumberInterval"blocks whose operations should be included
    "BlockNumber"number associated to a specific height on the blockchain
  • Common properties include:
  • "Address"Tezos address
    "Type"type of account
    "FirstBlockNumber"block height of the first operation related to the account
    "LastBlockNumber"height of the block in which the account state was changed last time
    "Balance"current value of the balance in mutez
    "ContractsCount"total number of contracts created and/or managed by the account
    "MigrationsCount"total number of migration operations related to the account
    "Staked"whether the account has staked its balance
    "TotalTransactions"total number of operations associated to this account
    "TotalTransactionsDetails"total number of operations associated to this account grouped by operation type
    "TransactionList"summary list of recent operations of the account
  • For accounts of type "User", additional properties include:
  • "TransactionCount"total number of operations sent by the account
    "Activated"whether the account was activated
    "Delegate"address of the current delegate of the account
    "DelegationBlockNumber"block height of latest delegation
    "StakingPower"total number of staking power units granted to the current delegate of the account
    "PublicKey"associated public key
    "Revealed"whether the public key was revealed
  • For accounts of type "Delegate", additional properties include:
  • "TransactionCount"total number of operations sent by the account
    "Activated"whether the account was activated
    "DelegateData"information about the delegate's baking activity
    "ContractType"type of contract
    "Manager"address of the account that was marked as a manager of the contract
  • For accounts of type "Contract", additional properties include:
  • "Delegate"address of the current delegate of the account
    "DelegationBlockNumber"block height of latest delegation
    "PublicKey"associated public key
    "Revealed"whether the public key was revealed
  • Additional properties when the association assoc contains "BlockNumber", "TimeInterval" or "BlockNumberInterval" elements include:
  • "BlockTransactions"total number of operations associated with the specified blocks
    "BlockTransactionsDetails"total number of operations associated with the specified blocks grouped by operation type
  • If the association assoc contains "BlockNumberInterval" or "TimeInterval", the output will include only a subset of available properties.
  • "DelegateData" gives an association with the following properties as its keys:
  • "ActivationBlockNumber"block height when delegate was registered as a baker last time
    "DeactivationBlockNumber"block height when delegate was deactivated as a baker because of lack of funds or inactivity
    "DelegatorsCount"number of current accounts that delegated their funds to the delegate
    "DelegatedBalance"total amount of mutez delegated to the delegate
    "StakersCount"number of current accounts that staked their funds to the delegate
    "StakedBalance"total amount of mutez staked to the delegate
    "BlocksCount"total number of baked blocks by the delegate
    "RevelationPenaltiesCount"total number of operations in which rewards were lost due to unrevealed seed nonces by the delegate
  • "TransactionList" gives a list of associations with a subset of properties from BlockchainTransactionData as their keys.
  • "ContractType" can return the following values:
  • "DelegateContract"contract used to delegate funds
    "SmartContract"general purpose contract
  • Possible options include:
  • BlockchainBase Automaticsets the blockchain and its network
    MaxItems 20the maximum number of items to return
  • BlockchainAddressData can access the Tezos mainnet (default) and testnet (Ghostnet). To specify these networks, use the BlockchainBase option.
  • The setting for MaxItems specifies the maximum number of operations to include in the result.

Examples

open allclose all

Basic Examples  (7)Summary of the most common use cases

Get information about a user account from the Tezos blockchain:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-vydue6
Out[1]=1

More information will be shown if the account belongs to a delegate:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-bvgoiw
Out[1]=1

Get data of an account after block 1,110,526 was baked:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-zdsn64
Out[1]=1

Filter the operations of a specific account by blocks:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-e86ekh
Out[1]=1

Filter the operations counts of a specific account by time:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-zsomrc
Out[1]=1

Get a property from a Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-u7rdm0
Out[1]=1

Get multiple properties from a Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-46vton
Out[1]=1

Scope  (23)Survey of the scope of standard use cases

Activated  (1)

Check whether the account was activated:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-8ga0eq
Out[1]=1

Address  (1)

Get the address that matches the provided one:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-3i3yjc
In[2]:=2
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-x3wg6x
Out[2]=2

Balance  (1)

Get the current balance of a Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-qnxv0p
Out[1]=1

BlockTransactions  (1)

Get the total number of operations associated with the specified block interval:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-d3bfp5
Out[1]=1

BlockTransactionsDetails  (1)

Get the total number of operations associated with the specified block interval grouped by operation type:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-sy7zkj
Out[1]=1

ContractsCount  (1)

Get the total number of contracts created or managed by a Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-omrjy3
Out[1]=1

ContractType  (1)

Get the type of contract using its address:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-zcc80e
Out[1]=1

Delegate  (1)

Get the address of the current delegate of a Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-fom82t
Out[1]=1

DelegateData  (1)

Get the delegate's baking activity information:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-ey3k3m
Out[1]=1

DelegationBlockNumber  (1)

Get the block height of latest delegation associated to a Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-nhyr6t
Out[1]=1

FirstBlockNumber  (1)

Get the block height of the first operation related to the Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-0jfsr7
Out[1]=1

LastBlockNumber  (1)

Get the height of the block in which the Tezos account state was changed last time:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-3oein8
Out[1]=1

Manager  (1)

Get the address of the account that was marked as a manager of the Tezos contract:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-h943x4
Out[1]=1

MigrationsCount  (1)

Get the total number of migrations related to the Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-n3fojh
Out[1]=1

PublicKey  (1)

Get the public key associated to a Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-nbh29d
Out[1]=1

Revealed  (1)

Check if a Tezos account has been revealed:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-ufcedl
Out[1]=1

Staked  (1)

Check whether the Tezos account has staked its balance:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-674d67
Out[1]=1

StakingPower  (1)

Check the current staking power of a Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-ct14xn
Out[1]=1

TotalTransactions  (1)

Get the total amount of operations associated to a Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-crn9ix
Out[1]=1

TotalTransactionsDetails  (1)

Get the total amount of operations associated to a Tezos account grouped by type:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-ynh3jv
Out[1]=1

TransactionCount  (1)

Get the total number of operations sent by the Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-gboesb
Out[1]=1

TransactionList  (1)

Get the list of recent operations associated with a Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-6payiv
Out[1]=1

Type  (1)

Get a Tezos account type:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-isqcyq
Out[1]=1

Options  (3)Common values & functionality for each option

BlockchainBase  (2)

Mainnet  (1)

Get information from a delegate in the Tezos mainnet:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-7gc5y9
Out[1]=1

Testnet  (1)

Get information from a delegate in the Tezos testnet:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-eqz3f0
Out[1]=1

MaxItems  (1)

List the last 10 operations for a Tezos account:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-c7l8m8
Out[1]=1

Properties & Relations  (2)Properties of the function, and connections to other functions

A Tezos account can be specified in three different forms:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-4o5pmp
In[2]:=2
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-fl80c1
In[3]:=3
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-cer1bd

All are equivalent:

In[4]:=4
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-h8wxqf
Out[4]=4

The value returned by the "Address" property is the same as the provided address:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-uc9ut0
In[2]:=2
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-gujw1c
Out[2]=2

Possible Issues  (2)Common pitfalls and unexpected behavior

Nonexistent Addresses  (1)

Using an address from one network in another network will return a Missing output:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-s84ren
In[2]:=2
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-hxhsea
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-n1mgbb
Out[3]=3

Incorrect Addresses  (1)

Providing an invalid address, public key or username will return a $Failed output:

In[1]:=1
✖
https://wolfram.com/xid/06mfdn3kdsxrfybej7z1t2zdqw1le4qfnetw0f8fiodo0-1wshvl
Out[1]=1
Wolfram Research (2020), BlockchainAddressData, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Tezos.html.
✖
Wolfram Research (2020), BlockchainAddressData, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Tezos.html.

Text

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

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

CMS

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

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

APA

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

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

BibTeX

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

✖
@misc{reference.wolfram_2025_blockchainaddressdata, author="Wolfram Research", title="{BlockchainAddressData}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Tezos.html}", note=[Accessed: 30-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_blockchainaddressdata, organization={Wolfram Research}, title={BlockchainAddressData}, year={2020}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Tezos.html}, note=[Accessed: 30-March-2025 ]}

✖
@online{reference.wolfram_2025_blockchainaddressdata, organization={Wolfram Research}, title={BlockchainAddressData}, year={2020}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Tezos.html}, note=[Accessed: 30-March-2025 ]}