Skip to main content

Get Assets Owned By Account

POST
Retrieves the list of TRC-10 assets held by a specific account.

🚧 What is TRC10?

TRC10 is the native token standard supported by Tron. Tokens issued under this standard are created according to the specification built into the Tron chain itself without using smart contracts. Thanks to this structural characteristic, tokens can be issued easily without complex processes, and each token is identified by a unique Asset ID.

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.
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.
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.
ownerAddressstringrequired
TRON address of the account owner. The address is a 34-character Base58 string format starting with "T".
balancestringrequired
Represents the current balance of the account. The value is a decimal string in SUN, the smallest unit of TRX (1 TRX = 1,000,000 SUN).
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 }"
}
cURL
curl -X POST 'https://web3.nodit.io/v1/tron/mainnet/asset/getAssetsOwnedByAccount' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "accountAddress": "T9123456789012345678901234567890123456789",
    "assetIds": [
      1002000,
      1002357,
      1004777
    ],
    "page": 1,
    "rpp": 10,
    "withCount": false
  }'