Get Asset Transfers By Account

POST

Retrieves the TRC-10 asset transfer history for a specific account.

Path Parameters

chainstringrequired

Parameter specifying the target chain to query.

networkstringrequired

Parameter specifying the network of the target chain.

Request Body

accountAddressstringrequired

Parameter specifying the account address to query. This field uses a 34-character base58 string format starting with "T".

assetIdsarray

Enter the list of Asset IDs to query. Each Asset ID must be an integer greater than 0.

fromBlockstring

Parameter specifying the starting point for the query. You can enter block number, block hash, or block tag. Default is 0.

block number: Enter as a decimal string.
block hash: Enter as a 64-character hexadecimal string, excluding the 0x prefix.
block tag: You can enter "earliest" for fromBlock.

Notes:

If only fromBlock is provided without toBlock, results are queried from fromBlock to the most recent block.
fromBlock's block number must be less than or equal to toBlock's block number.
If toBlock and fromBlock have the same value, only that single block's results are queried.
"latest" cannot be entered for fromBlock.

toBlockstring

Parameter specifying the ending point for the query. You can enter block number, block hash, or block tag. Default is "latest".

block number: Enter as a decimal string.
block hash: Enter as a 64-character hexadecimal string, excluding the 0x prefix.
block tag: You can enter "latest".

Notes:

The blockNumber for toBlock must be greater than or equal to the blockNumber for fromBlock.
If toBlock and fromBlock have the same value, only that single block's results are queried.
If only toBlock is provided without fromBlock, results are queried from genesis block to the time specified in toBlock.
"earliest" cannot be entered for toBlock.

fromDatestring

Parameter specifying the start date for the query. Date must follow ISO 8601 format (YYYY-MM-DDThh:mm:ss{time zone}) including seconds.Notes:

If provided without toDate, results are queried from this date to the latest block.
fromDate value must be equal to or earlier than toDate value.
If fromDate and toDate have the same value, only blocks from that date are queried.
This field cannot be used together with fromBlock and toBlock.
If fromDate and toDate are not provided, the API queries data from the latest 30 days.

toDatestring

Parameter specifying the end date for the query. Date must follow ISO 8601 format (YYYY-MM-DDThh:mm:ss{time zone}) including seconds.Notes:

If provided without fromDate, results are queried from genesis block to this date.
toDate value must be equal to or later than fromDate value.
If fromDate and toDate have the same value, only blocks from that date are queried.
This field cannot be used together with fromBlock and toBlock.
If fromDate and toDate are not provided, the API queries data from the latest 30 days.

pageinteger

The page parameter specifies the data page to query. It accepts values up to 100; for pages exceeding 100, use the cursor pagination method.The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.

rppinteger

rpp stands for results per page and specifies the page size. You can specify a number greater than 0 and up to 100.

cursorstring

The cursor parameter supports pagination and data navigation between pages. Provide the cursor value from the previous page in the next request to load the next page of data.The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.

withCountboolean

Parameter specifying whether to include the count field in the response. The count field indicates the total number of requested data items. When set to true, the count field is included and response speed may be slower.

withZeroValueboolean

Parameter specifying whether to include results with value 0 in the response. Set to true for faster responses.

Responses

pageinteger

Field representing the page number specified in the page parameter. This field is only included in the response when a value greater than 0 is specified for the page parameter.

rppinteger

Field representing the number of results per page specified in the rpp parameter.

cursorstring

A field for cursor pagination. This value must be provided in the next request to load the next page of data.

countinteger

Field representing the total count of requested data. This field is only included in the response when true is set for the withCount parameter.

Field representing the actual range applied to the query. The same kind of values used in the request's range parameters are returned. A Date-based request returns fromDate and toDate, a Block-based request returns fromBlock and toBlock, and a Ledger-based request returns fromLedger and toLedger; different kinds are never mixed in a single response. When all range parameters are omitted, a default window of the last 30 days is applied and fromDate, toDate are returned. Block and Ledger values are always returned as heights (numbers), even if a hash or tag (latest, earliest) was provided in the request.

fromDatestring

Field representing the start of the query range in Date mode. Returned in ISO 8601 format.

toDatestring

Field representing the end of the query range in Date mode. Returned in ISO 8601 format.

fromBlockinteger

Field representing the start block height of the query range in Block mode.

toBlockinteger

Field representing the end block height of the query range in Block mode.

fromLedgerinteger

Field representing the start ledger index of the query range in Ledger mode.

toLedgerinteger

Field representing the end ledger index of the query range in Ledger mode.

fromstringrequired

Represents the address that initiated the transaction. This address refers to the account or smart contract that sends assets. This field has a 34-character base58 string format starting with "T".

tostringrequired

Represents the recipient address of the transaction. This address refers to the account or smart contract that receives assets. This field has a 34-character base58 string format starting with "T".

valuestringrequired

Represents the amount of assets or data transferred. For TRC10 and TRC20, it indicates the amount transferred.

blockTimestampintegerrequired

Indicates when the block containing the transaction was created. Recorded in UNIX timestamp format in milliseconds, used to verify when the transaction occurred.

blockNumberintegerrequired

Indicates the block number containing the transaction. Used to trace the transaction on the blockchain and identify the transaction's position within a specific block.

transactionHashstringrequired

Represents the unique hash of the transaction. Used as the transaction identifier and serves as the key to trace all data related to the transaction.

transactionIndexintegerrequired

Indicates the position of the transaction within the block containing it. Used to identify the order of the transaction among multiple transactions in a block.

logIndexinteger

Indicates the index of the log containing this Transfer event. Used to identify a specific log when multiple logs exist within the same block.

internalTransactionIndexinteger

Indicates the index of the internal transaction related to TRX or TRC10 transfer. Used to distinguish among multiple internal transactions within a block.<strong style='color: red;'>*</strong> When this value is "-1", it indicates a Root Transaction.

exchangeIdinteger

Unique ID that identifies a swap transaction on the decentralized exchange (DEX) provided by the TRON network. Used to distinguish specific swap transactions and track which asset pair was traded. Returns null when the transfer is not from a swap transaction.

idintegerrequired

Represents the unique ID of the TRC10 token. This ID is used to identify a specific TRC10 asset issued on the TRON network.

namestringrequired

Represents the name of the contract. Returns an empty string if the contract does not follow the standard or if the name ("name") was not provided during contract creation.

symbolstringrequired

Represents the symbol of the contract. Returns an empty string if the contract does not follow the standard or if the symbol ("symbol") was not provided during contract creation.

totalSupplystringrequired

Represents the total supply of the contract. This value is the total token issuance and is displayed as a decimal string.

decimalsintegerrequired

Represents the number of decimal places for the token. Before the TIP10 standard was introduced, the "precision" value was set to 0.

startTimeintegerrequired

Represents the ICO (Initial Coin Offering) start time. This value is recorded as a UNIX timestamp in milliseconds.

endTimeintegerrequired

Represents the ICO end time. This value is also recorded as a UNIX timestamp in milliseconds.

descriptionstringrequired

Represents the description of the TRC10 token. This value is set by the issuer and may be subject to change.

urlstringrequired

Represents the URL for the TRC10 token. This value is also set by the issuer and may be subject to change.

blockNumberintegerrequired

Represents the block number in which the TRC10 token was created. This is the block number containing the token creation transaction, used to trace the transaction on the blockchain.

blockTimestampintegerrequired

Represents when the TRC10 token was created. Recorded as a UNIX timestamp in milliseconds, used to determine when the asset was created.

transactionHashstringrequired

Represents the hash of the transaction that issued the TRC10 token. Used to identify and query information about the specific TRC10 issuance transaction.

deployerstringrequired

Represents the account or address that issued the TRC10 token. Identifies the issuer's owning account and serves as the basis for all related asset management and information queries.

trxNumintegerrequired

Represents the quantity of TRX used to determine the value of the TRC10 asset. This value is calculated as the "trx_num/num" ratio, with the unit in sun.

numintegerrequired

Represents the quantity of TRC10 used to determine the value of the TRC10 asset. The TRC10 asset value is calculated as the "trx_num/num" ratio.

codestringrequired

Code identifying the cause of the failed request.

messagestringrequired

Detailed message including the name and value of the invalid parameter.

{
  "code": "MISSING_REQUIRED_PARAMETER",
  "message": "Missing required parameter: { PARAMETER_NAME }"
}

X-API-KEY

cURL

curl -X POST 'https://web3.nodit.io/v1/tron/mainnet/asset/getAssetTransfersByAccount' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "accountAddress": "T9123456789012345678901234567890123456789",
    "assetIds": [
      1002000,
      1002357,
      1004777
    ],
    "fromBlock": "80453005",
    "toBlock": "80453006",
    "fromDate": "2025-01-01T00:00:00+00:00",
    "toDate": "2025-01-31T00:00:00+00:00",
    "page": 1,
    "rpp": 10,
    "withCount": false
  }'