Transactions - By Address

Retrieves the transactions where this address was either the originator or a recipient.

Note that transactions are returned in descending order by default (block number and transaction index), which means the most recent transactions are on page 0, and the oldest transactions are on the last page.

If you intend to traverse all the transactions, it is recommended to specify the flag direction=ascending, which will guarantee that the pagination is stable and will not change with the arrival of new transactions.

👍

Blockchains Supported

This endpoint supports Bitcoin, Bitcoin Cash, Litecoin and Ethereum.

Response

Field

Type

Description

records

array

An array containing objects containing data pertaining to the specified transaction.

hash

string

The transaction hash.

confirmations

string

The total number of confirmations.

nonce

string

The number of transactions sent from an address (this is typically used to prevent double spending for example).

blockHash

string

The block header hash of the block containing this transaction.

blockNumber

string

The blocknumber of the block which contains the specified transaction.

index

string

The index of the transaction within the block.

size

number

(ONLY FOR UTXO CHAINS) Size of the transaction.

virtualSize

number

(ONLY FOR UTXO CHAINS) Virtual size of the transaction.

from

object

Contains the details about the sending address. i.e. the address of the account.

address

string

The address hash of the sender.

to

array

Contains object that hold data about the recipient address(es).

icon

string

The image icon of the asset (where applicable).

address

string

The address hash of the recipient.

value

string

The scalar value equal to the number of units (in Ethereum Wei) to be transferred to the message call’s recipient or, in the case of contract creation, as an endowment to the newly created contract. See full value conversion reference here.

input

string

The input data to the function.

inputSize

number

The size in bytes of the input data.

logsBloom

string

The Bloom filter composed from indexable information (logger address and log topics) contained in each log entry from the receipt of each transaction in the transactions list.

fee

string

The transaction fee.

gasPrice

string

The gas price at the time of the transaction.

gasLimit

string

The gas limit of the transaction.

cumulativeGasUsed

string

The total gas used up to and including the transaction.

gasUsed

string

Total gas used by the transaction.

contractAddress

string

If the transaction created a contract it will be the contract address and null otherwise.

maxFeePerGas

number

Maximum amount that can be paid to validate and include this transaction in the blockchain.

maxPriorityFeePerGas

number

Fees which go to the miner, also known as tips or inclusion fees.

nonce

string

The nonce of the transaction.

raw

string

The signed transaction in Recursive Length Prefix (RLP) encoded form.

root

string

The transaction root hash.

s

string

ECDSA digital signature s (32 bytes) generated by private key and used to validate the sender of the transaction.

type

number

The transaction type:
0 - legacy
2 - EIP 1559

r

string

ECDSA digital signature r (32 bytes) generated by private key and used to validate the sender of the transaction.

status

string

The status of the transaction.
0x1 - success
0x0 - failed

statusResult

object

Contains details about the transaction status.

decodedTransactionInput

string

The 'input' field of transactions decoded, using the ABI of the involved contract .

code

string

The status of the transaction:
null - pending
0x1 - success
0x0 - failed

confirmed

bool

true if the transactions has been confirmed false otherwise.

success

bool

Indicates the success or failure of a transaction:
null - pending
true - success
false - failed

name

string

The string representation of the transaction status:

  • 'pending'
  • 'failed'
  • 'successful'

numLogs

string

The total number of logs contained within this transaction.

timestamp

number

The time of when the transaction was confirmed.

timestampNanoseconds

number

The nano second part of the timestamp, where applicable.

blockchainId

string

The id of the blockchain on which the transaction resides.

v

string

Used by ECDSA to recover correct public key when validating signature of transactions. Combination of recovery id and chain id.

publicKey

string

The public key hash.

Language
Credentials
Header
Click Try It! to start a request and see the response here!