WOLFRAM

Wolfram Language & System Documentation Center

BlockchainAddressData (for Cardano)

BlockchainAddressData["address"]

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

BlockchainAddressData[addressSpec,prop]

gives the specified property of the Cardano blockchain address.

Details

  • The blockchain address can be specified as follows:
  • "address"address on the Cardano mainnet blockchain
    "chain""address"address on the specified public blockchain
    {"chain","network"}"address"address on a specific network for a Cardano blockchain
  • For payment addresses, properties include:
  • "Address"Cardano address
    "Balance"current value of the balance in lovelace
    "ValueInUSDollars"current value of the balance in US dollars
    "AssetBalances"summary list of assets owned by the address
    "TotalUTXO"total number of unspent transaction outputs associated to this address
    "UTXOList"summary list of unspent transaction outputs of this address
    "TotalTransactions"total number of transactions associated to this address
    "TransactionList"summary list of recent transactions of the address
  • For stake addresses, properties include:
  • "Address"Cardano address
    "TotalWithdrawn"total value of withdrawn rewards in lovelace
    "ValueInUSDollars"total value of withdrawn rewards in US dollars
    "WithdrawalList"summary list of recent withdrawal transactions of the address
  • "AssetBalances" gives a list of associations with the following properties as their keys:
  • "AssetID"asset ID of the token (policy ID concatenated with asset name)
    "AssetName"asset name of the token
    "PolicyID"token policy ID
    "Fingerprint"encoded token asset ID
    "Quantity"token amount owned by the address
  • Possible options include:
  • BlockchainBase $BlockchainBasesets the blockchain and its network
    MaxItems 20the maximum number of items to return
  • BlockchainAddressData can access the Cardano mainnet (default) and testnet "preprod", which is a new network for testing purposes. 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 all close all

Basic Examples  (4)

Get information about a non-staking address from the Cardano blockchain:

Wolfram Language code: BlockchainAddressData["addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k", BlockchainBase -> "Cardano"]//Dataset

Get information about a stake address from the Cardano blockchain:

Wolfram Language code: BlockchainAddressData["stake1uyqkmda5cspcknq60hzkk0xprtnwx27gaxppan0tr90j9ssql6ess", BlockchainBase -> "Cardano"]//Dataset

Get a property from a Cardano address:

Wolfram Language code: BlockchainAddressData["addr1v94xluc70dxdn07ppd9aukkejqq2zht4ezpmsk0v3g2vcaqsyta07", "Balance", BlockchainBase -> "Cardano"]

Get multiple properties from a Cardano address:

Wolfram Language code: BlockchainAddressData["addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k", {"Balance", "TotalUTXO"}, BlockchainBase -> "Cardano"]

Scope  (11)

Address  (1)

Get the address that matches the provided one:

Wolfram Language code: addresses = {"Alice" -> "addr1v94xluc70dxdn07ppd9aukkejqq2zht4ezpmsk0v3g2vcaqsyta07", "Bob" -> "addr1v800jtvhk7gcz994587vjvjv7rvnw3q0caewddt08nzkujquvscvq" };
Wolfram Language code: BlockchainAddressData["Alice" /. addresses, "Address", BlockchainBase -> "Cardano"]

AssetBalances  (1)

Get the balance of assets of a Cardano address:

Wolfram Language code: BlockchainAddressData["addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k", "AssetBalances", BlockchainBase -> "Cardano"]//Dataset

Balance  (1)

Get the current balance of a Cardano account:

Wolfram Language code: BlockchainAddressData["addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k", "Balance", BlockchainBase -> "Cardano"]

TotalTransactions  (1)

Get the total number of transactions of a Cardano address:

Wolfram Language code: BlockchainAddressData["addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k", "TotalTransactions", BlockchainBase -> "Cardano"]

TotalUTXO  (1)

Get the total amount of UTXOs of a Cardano address:

Wolfram Language code: BlockchainAddressData["addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k", "TotalUTXO", BlockchainBase -> "Cardano"]

TotalWithdrawals  (1)

Get the total number of withdrawals of a Cardano stake address:

Wolfram Language code: BlockchainAddressData["stake1uyqkmda5cspcknq60hzkk0xprtnwx27gaxppan0tr90j9ssql6ess", "TotalWithdrawals", BlockchainBase -> "Cardano"]

TotalWithdrawn  (1)

Get the total withdrawn amount of a Cardano stake address:

Wolfram Language code: BlockchainAddressData["stake1uyqkmda5cspcknq60hzkk0xprtnwx27gaxppan0tr90j9ssql6ess", "TotalWithdrawn", BlockchainBase -> "Cardano"]

TransactionList  (1)

Get the list of transactions associated with a Cardano address:

Wolfram Language code: BlockchainAddressData["addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k", "TransactionList", BlockchainBase -> "Cardano"]//Dataset

UTXOList  (1)

Get the list of UTXOs of a Cardano address:

Wolfram Language code: BlockchainAddressData["addr1v94xluc70dxdn07ppd9aukkejqq2zht4ezpmsk0v3g2vcaqsyta07", "UTXOList", BlockchainBase -> "Cardano"]

ValueInUSDollars  (1)

Get the current balance of a Cardano address balance in US dollars:

Wolfram Language code: BlockchainAddressData["addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k", "ValueInUSDollars", BlockchainBase -> "Cardano"]

WithdrawalList  (1)

Get the list of withdrawals associated with a Cardano stake address:

Wolfram Language code: BlockchainAddressData["stake1uyqkmda5cspcknq60hzkk0xprtnwx27gaxppan0tr90j9ssql6ess", "WithdrawalList", BlockchainBase -> "Cardano"]//Dataset

Options  (3)

BlockchainBase  (2)

Mainnet  (1)

Get information from a Cardano mainnet address:

Wolfram Language code: BlockchainAddressData["addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k", BlockchainBase -> "Cardano", BlockchainBase -> {"Cardano", "Mainnet"}]//Dataset

Testnet  (1)

Get information from a Cardano testnet address:

Wolfram Language code: BlockchainAddressData["addr_test1qzdxxk4w4gnzpsfgmvc0e4nkz4m4ted406szgyxrj4nrwxungrfzkzylfrg9z04xgh69q4wx2rgscgktt8ptezuxca8su66rtd", BlockchainBase -> {"Cardano", "Testnet"}]//Dataset

MaxItems  (1)

List the last 5 transactions for a Cardano address:

Wolfram Language code: BlockchainAddressData["addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k", "TransactionList", BlockchainBase -> "Cardano", MaxItems -> 5]//Dataset

Applications  (1)

Create a simple gallery of NFTs owned by an address:

Wolfram Language code: assets = BlockchainAddressData["addr1qx9wpgszhgg56n5wh8u2dmt5qxe47hvlcwnm27qjsshnp8vln7wc84w9kzz0mv4juty0k3k0fp9ust99hapyuj6qlvdss9nyan", "AssetBalances", BlockchainBase -> "Cardano"];
Wolfram Language code: fingerprintsAndNames = Take[Lookup[assets, {"Fingerprint", "AssetName"}], 6];
Wolfram Language code: cids = Function[u, StringDrop[Last[Values[BlockchainTransactionData[BlockchainTokenData[u[[1]], BlockchainBase -> "Cardano"][[1]]["TokenMints"][[-1]]["TransactionID"], "Metadata", BlockchainBase -> "Cardano"]["721"]]][FromCharacterCode[FromDigits[#, 16]& /@ StringPartition[u[[2]], 2]]]["image"], 7]] /@ fingerprintsAndNames
Wolfram Language code: images = Import /@ (ExternalStorageDownload[#, ExternalStorageBase -> "IPFS"]& /@ cids);
Wolfram Language code: ImageCollage[images]

Properties & Relations  (1)

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

Wolfram Language code: address = "addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k";
Wolfram Language code: BlockchainAddressData[address, "Address", BlockchainBase -> "Cardano"] === address

Possible Issues  (2)

Nonexistent Addresses  (1)

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

Wolfram Language code: address = "addr1q9z402ku7wxyskdesghykhx6rg6pq094p58mrnz6wljpplp3n0hl2vj3ym76928gs57lg4sfhlymtvd76a7xys4vdfjqcemy4k";
Wolfram Language code: BlockchainAddressData[address, BlockchainBase -> {"Cardano", "Mainnet"}]//Dataset
Wolfram Language code: BlockchainAddressData[address, BlockchainBase -> {"Cardano", "Testnet"}]

Incorrect Addresses  (1)

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

Wolfram Language code: BlockchainAddressData["x!=#%", BlockchainBase -> "Cardano"]
Wolfram Research (2021), BlockchainAddressData, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Cardano.html.

Text

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

CMS

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

APA

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

BibTeX

@misc{reference.wolfram_2026_blockchainaddressdata, author="Wolfram Research", title="{BlockchainAddressData}", year="2021", howpublished="\url{https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Cardano.html}", note=[Accessed: 13-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_blockchainaddressdata, organization={Wolfram Research}, title={BlockchainAddressData}, year={2021}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Cardano.html}, note=[Accessed: 13-June-2026]}