WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

BlockchainAddressData  (for Bitcoin)

[Experimental]
$BlockchainBase = "Bitcoin"

BlockchainAddressData["address"]

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

BlockchainAddressData[assoc]

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

BlockchainAddressData[addressSpec,prop]

gives the specified property of the Bitcoin blockchain address.

Details

  • The blockchain address can be specified as follows:
  • "address"address on the Bitcoin blockchain
    "chain""address"address on the specified public blockchain
    {"chain","network"}"address"address on a specific network for a Bitcoin 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 Bitcoin blockchain
    "TimeInterval"time interval for transactions to be included
    "BlockNumberInterval"blocks interval for transactions to be included
    "BlockNumber"number associated to a specific height on the blockchain
  • Properties include:
  		• "Address"Bitcoin address
    "Balance"current value of the balance in bitcoins
    "ValueInUSDollars"current value of the balance in US dollars
    "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
  • If the association assoc contains "BlockNumber", "BlockNumberInterval" or "TimeInterval", the output will include only a subset of available properties.
  • "TransactionList" gives an association with the following properties as its keys:
  • "TransactionID"transaction hash
    "BlockNumber"block number including the transaction
    "Timestamp"timestamp of the block
    "Inputs"inputs of the transaction
    "Outputs"outputs of the transaction
  • Possible options include:
  • BlockchainBase Automaticsets the blockchain and its network
    MaxItems 20the maximum number of items to return
  • BlockchainAddressData can access the Bitcoin mainnet (default) and testnet networks. To specify these networks, use the BlockchainBase option.
  • The setting for MaxItems specifies the maximum number of transactions to include in the result.

Examples

open allclose all

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

Check a Bitcoin address on main network:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-yc77zd
Out[1]=1

Specify the blockchain in the first argument:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-2g3c7o
Out[1]=1

Specify the blockchain and network in the first argument:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-u24b98
Out[1]=1

Get data of an address up to the block height 170,000:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-lpqsvq
Out[1]=1

Filter the list of transactions of a specific address by blocks:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-ysjsi3
Out[1]=1

Filter the list of transactions of a specific address by time:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-fbh9oa
Out[1]=1

Get a property from a Bitcoin address:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-iiewpd
Out[1]=1

Get multiple properties from a Bitcoin address:

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

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

Address  (1)

Get the address that matches the provided one:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-5dh5cr
In[2]:=2
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-ys0dtc
Out[2]=2

Balance  (1)

Get the current balance of a Bitcoin address:

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

TotalTransactions  (1)

Get the total amount of transactions associated with a Bitcoin address:

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

TotalUTXO  (1)

Get the total amount of UTXOs of a Cardano address:

In[2]:=2
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-isqcyq
Out[2]=2

TransactionList  (1)

Get the list of transactions associated with a Bitcoin address:

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

UTXOList  (1)

Get the list of UTXOs of a Cardano address:

In[2]:=2
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-uzjyws
Out[2]=2

ValueInUSDollars  (1)

Get the current value of a Bitcoin address balance in US dollars:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-xoceor
Out[1]=1

Options  (3)Common values & functionality for each option

BlockchainBase  (2)

Mainnet  (1)

Get information from a Bitcoin mainnet address:

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

Testnet  (1)

Get information from a Bitcoin testnet address:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-id19ts
Out[1]=1

MaxItems  (1)

List the last five transactions for a Bitcoin address:

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

Applications  (1)Sample problems that can be solved with this function

Get the "ValueInUSDollars" property of a specific Bitcoin address:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-xq75za
Out[1]=1

Convert the amount to another currency:

In[2]:=2
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-sp4qi7
Out[2]=2

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

A Bitcoin address can be specified in three different forms:

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

All are equivalent:

In[4]:=4
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-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/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-uc9ut0
In[2]:=2
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-gujw1c
Out[2]=2

When filtering an address by "BlockNumber", "BlockNumberInterval" or "TimeInterval", the output will not include all available properties, but only a subset:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-j3fq68
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-thmf6e
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-71lkcl
Out[3]=3

Filtering an address using "BlockNumber" to specify a block is equivalent to using "BlockNumberInterval" with an interval from block 0 to the specified block:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-i2rmj8
In[2]:=2
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-p5uka6
In[3]:=3
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-kgsqpu
Out[3]=3

Possible Issues  (3)Common pitfalls and unexpected behavior

Nonexistent Addresses  (2)

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

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-hxhsea
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-qxjncb
Out[2]=2

Filtering an address by a block height or time when the address did not exist in the blockchain will return a Missing output:

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-ral7wm
Out[1]=1

Incorrect Addresses  (1)

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

In[1]:=1
✖
https://wolfram.com/xid/0202taka9eu5jbm92386rvslc2ij6lcm1ybqhjk6ubr15u-1wshvl
Out[1]=1
Wolfram Research (2019), BlockchainAddressData, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Bitcoin.html.
✖
Wolfram Research (2019), BlockchainAddressData, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Bitcoin.html.

Text

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

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

CMS

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

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

APA

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

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

BibTeX

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

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

BibLaTeX

@online{reference.wolfram_2025_blockchainaddressdata, organization={Wolfram Research}, title={BlockchainAddressData}, year={2019}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Bitcoin.html}, note=[Accessed: 19-June-2025 ]}

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