Get Asset Metadata By IDs
POST
Retrieves metadata for a specific TRC-10 asset.
🚧 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
assetIdsarrayrequired
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
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/getAssetMetadataByIds' \-H 'Content-Type: application/json' \-H 'X-API-KEY: nodit-demo' \-d '{"assetIds": [1002000,1002357,1004777]}'