Get Asset Metadata By Issuer

POST

Retrieves metadata for TRC-10 assets issued by a specific issuer.

🚧 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

issuerstringrequired

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

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 }"
}

X-API-KEY

cURL

curl -X POST 'https://web3.nodit.io/v1/tron/mainnet/asset/getAssetMetadataByIssuer' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "issuer": "TTzC9cm1vbsyBzhC8n4z3k6eAVkryDyKU8"
  }'