BlockchainAddressData  (for Bitcoin)

$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
    "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)

Check a Bitcoin address on main network:

Specify the blockchain in the first argument:

Specify the blockchain and network in the first argument:

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

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

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

Get a property from a Bitcoin address:

Get multiple properties from a Bitcoin address:

Scope  (5)

Address  (1)

Get the address that matches the provided one:

Balance  (1)

Get the current balance of a Bitcoin address:

TotalTransactions  (1)

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

TransactionList  (1)

Get the list of transactions associated with a Bitcoin address:

ValueInUSDollars  (1)

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

Options  (3)

BlockchainBase  (2)

Mainnet  (1)

Get information from a Bitcoin mainnet address:

Testnet  (1)

Get information from a Bitcoin testnet address:

MaxItems  (1)

List the last five transactions for a Bitcoin address:

Applications  (1)

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

Convert the amount to another currency:

Properties & Relations  (4)

A Bitcoin address can be specified in three different forms:

All are equivalent:

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

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

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

Possible Issues  (3)

Nonexistent Addresses  (2)

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

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

Incorrect Addresses  (1)

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

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.

CMS

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

BibTeX

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

BibLaTeX

@online{reference.wolfram_2023_blockchainaddressdata, organization={Wolfram Research}, title={BlockchainAddressData}, year={2019}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Bitcoin.html}, note=[Accessed: 20-April-2024 ]}