Token Transfers - By Wallet Address

get https://api.amberdata.com/blockchains/addresses/{hash}/token-transfers

Retrieves all token transfers involving the specified address.

If you intend to traverse all the token-transfers, 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 token-transfers.

👍
Blockchains Supported
This endpoint supports Ethereum and Polygon.

Response Data

Field	Type	Description
records	`array`	Array of token transfer objects.
totalRecords	`number`	Total number of token transfers returned in the response.
amount	`string`	The amount transferred in the smallest unit of the blockchain. For instance, wei with Ethereum. Important note: If the token type is ERC721, the amount value represents the token id
blockHash	`string`	The header hash of the block containing this token transfer.
blockNumber	`string`	The number of the block containing this token transfer.
blockchainId	`string`	The id of the blockchain on which the transaction resides.
decimals	`string`	The number of significant digits, per smart contract definition (-1 means that information was not advertised by the contract).
from	`object`	The address hash of the sender.
isERCX	`boolean`	`true` if the token is ERCX `false` otherwise.
logIndex	`string`	The index of the log in the transaction.
name	`string`	The token name.
symbol	`string`	The token symbol.
timestamp	`number`	The time of when the transaction was confirmed.
timestampNanoseconds	`number`	The nano second part of the timestamp, where applicable.
to	`array`	The address hash(es) of the recipient(s).
tokenAddress	`string`	The address of the token contract.
transactionHash	`string`	The hash of the transaction.

Path Params

hash

string

required

Defaults to 0x06012c8cf97bead5deae237070f9587f8e7a266d

The address to retrieve the token transfers for

Query Params

amount

int32

Filter by token transfers which value is equal to this amount.

amountGt

int32

Filter by token transfers which value is greater than this amount.

amountGte

int32

Filter by token transfers which value is greater than or equal to this amount.

amountLt

int32

Filter by token transfers which value is less than this amount.

amountLte

int32

Filter by token transfers which value is less than or equal to this amount

blockNumber

int32

Filter by token transfers with this block number.

startDate

date-time

Filter by token transfers which happened after this date.

endDate

date-time

Filter by token transfers which happened before this date.

transactionHash

string

Filter by token transfers for this transaction hash.

direction

string

The order in which to return the results (ascending or descending). By default, records are returned in descending order, so the most recent records are returned first.

page

int32

Defaults to 0

The page number to return.

size

int32

Defaults to 50

Number of records per page.

validationMethod

string

The validation method to be added to the response: none, basic, full. Default: none. More Details.

includePrice

boolean

Indicates whether or not to include price data with the results. Options: true, false. More Details.

currency

string

The currency of the price information. Options: usd, btc. Only used in conjunction with includePrice. More Details.

timeFormat

string

[Optional] Time format of the timestamps in the return payload.
[Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable

Headers

x-amberdata-blockchain-id

string

Defaults to ethereum-mainnet

The id of the blockchain

Responses

xxxxxxxxxx
curl --request GET \
     --url 'https://api.amberdata.com/blockchains/addresses/0x06012c8cf97bead5deae237070f9587f8e7a266d/token-transfers?page=0&size=50' \
     --header 'accept: application/json' \
     --header 'x-amberdata-blockchain-id: ethereum-mainnet' \
     --header 'x-api-key: API_KEY'

👍Blockchains Supported

Response Data

200200

400400

👍
Blockchains Supported