BlockchainAddressData  (for Ethereum)

$BlockchainBase = "Ethereum"

BlockchainAddressData["address"]

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

BlockchainAddressData[assoc]

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

BlockchainAddressData[addressSpec,prop]

gives the specified property of the Ethereum blockchain address.

Details

  • The blockchain address can be specified as follows:
  • "address"address on the Ethereum blockchain
    "chain""address"address on the specified public blockchain
    {"chain","network"}"address"address on a specific network for an Ethereum 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 Ethereum blockchain
    "TimeInterval"time interval for transactions to be included
    "BlockNumberInterval"blocks whose transactions should be included
    "BlockNumber"number associated to a specific height on the blockchain
  • Properties include:
  • "Address"Ethereum address
    "Type"type of the address
    "DeploymentData"summary of the transaction that deployed the contract
    "Balance"current value of the balance in wei
    "ValueInUSDollars"current value of the balance in US dollars
    "TransactionCount"number of transactions sent by the address
    "TotalTransactions"total number of transactions associated to this address
    "TotalInternalTransactions"total number of internal transactions associated to this address
    "TotalEvents"total number of events emitted by this address
    "TransactionList"summary list of recent transactions of this address
    "InternalTransactionList"summary list of recent internal transactions of this address
    "EventList"summary list of recent events triggered by this address
  • Additional properties when the association assoc contains "BlockNumber", "TimeInterval" or "BlockNumberInterval" elements include:
  • "BlockTransactions"total number of transactions associated with the specified blocks
    "BlockInternalTransactions"total number of internal transactions associated with the specified blocks
    "BlockEvents"total number of events associated with the specified blocks
  • If the association assoc contains "BlockNumber", the "ValueInUSDollars" property will return the value of the balance at the time when the block was added to the blockchain.
  • If the association assoc contains "BlockNumberInterval" or "TimeInterval", the output will include only a subset of available properties.
  • The "Type" property can be "Contract" or "Externally Owned Account".
  • "DeploymentData" gives an association with the following properties as its keys:
  • "BlockNumber"height associated to the contract deployment transaction
    "Timestamp"time associated to the contract deployment transaction
    "TransactionID"transaction hash associated to the contract deployment transaction
    "Sender"sender address associated to the contract deployment transaction
  • Common properties for output lists include:
  • "TransactionID"transaction hash
    "BlockNumber"block number including the transaction
    "Timestamp"timestamp of the block
  • Additional properties for "TransactionList" include:
  • "Sender"sender of the transaction
    "Receiver"receiver of the transaction
    "Amount"amount of currency sent
  • Additional properties for "InternalTransactionList" include:
  • "CallType"internal transaction type of execution
    "Sender"sender of the transaction
    "Receiver"receiver of the transaction
    "Amount"amount of currency sent
  • Additional properties for "EventList" include:
  • "Address"address of the contract that triggered the event
    "Topics"event's parameters indexed in the transaction receipt log
    "Data"event's parameters encoded in the transaction receipt log
  • Possible options include:
  • BlockchainBase Automaticsets the blockchain and its network
    MaxItems 20the maximum number of items to return
  • BlockchainAddressData can access the Ethereum mainnet (default) and testnet (Sepolia). To specify these networks, use the BlockchainBase option.
  • The setting for MaxItems specifies the maximum number of events, internal transactions and transactions to include in the result.

Examples

open allclose all

Basic Examples  (7)

Check an Ethereum 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 when block 1,718,497 was mined:

Filter the events of a specific address by blocks:

Filter the internal transactions of a specific address by time:

Get a property from an Ethereum address:

Get multiple properties from an Ethereum address:

Scope  (15)

Address  (1)

Get the address that matches the provided one:

Balance  (1)

Get the current balance of an Ethereum address:

BlockEvents  (1)

Get total number of events associated with the specified block:

BlockInternalTransactions  (1)

Get the total number of internal transactions associated with the specified block:

BlockTransactions  (1)

Get the total number of transactions associated with the specified block:

DeploymentData  (1)

Get a summary of the transaction that deployed the contract:

EventList  (1)

Get the last five events associated with an Ethereum address:

InternalTransactionList  (1)

Get the last five internal transactions associated with an Ethereum address:

TotalEvents  (1)

Get the total number of events associated with an Ethereum address:

TotalInternalTransactions  (1)

Get the total number of internal transactions associated with an Ethereum address:

TotalTransactions  (1)

Get the total number of transactions associated to an Ethereum address:

TransactionCount  (1)

Get the total number of transactions sent by an Ethereum address:

TransactionList  (1)

Get the five latest transactions associated with an Ethereum address:

Type  (1)

Get the type of an Ethereum address:

ValueInUSDollars  (1)

Get the current value of an Ethereum address balance in US dollars:

Options  (5)

BlockchainBase  (2)

Mainnet  (1)

Check an Ethereum address on the main network:

Testnet  (1)

Check an Ethereum address on the test network:

MaxItems  (3)

List the last 10 transactions for an Ethereum address:

Get the last five events associated with an Ethereum address:

Get the last five internal transactions associated with an Ethereum address:

Applications  (1)

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

Convert the amount to another currency:

Properties & Relations  (2)

An Ethereum address can be specified in three different forms:

All are equivalent:

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

Possible Issues  (4)

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:

Unavailable Value in US Dollars  (1)

When filtering an address by "BlockNumber", the "ValueInUSDollars" property will return the value of the balance in US dollars at the time when the block was mined. If there is no available information about the value associated with that particular time, a Missing output will be returned:

You can still convert the balance from that time to another currency, using the current exchange rate, with CurrencyConvert:

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

Text

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

CMS

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

APA

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

BibTeX

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

BibLaTeX

@online{reference.wolfram_2024_blockchainaddressdata, organization={Wolfram Research}, title={BlockchainAddressData}, year={2019}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainAddressData-Ethereum.html}, note=[Accessed: 21-November-2024 ]}