POSTSearch Asset Metadata By Keyword

Data APIhttps://web3.nodit.io/v1/tron/mainnet/asset/searchAssetMetadataByKeyword

Searches for TRC-10 asset metadata by keyword.

Path Parameters
chainstring (enum)required

Parameter to specify the target chain for the query.

networkstring (enum)required

Parameter to specify the network of the target chain. Supported networks may vary depending on the chain.

Request Body
keywordstringrequired

Parameter specifying the name or symbol of the token to query.

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.

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.

X-API-KEY
RequestCU500
cURL
curl -X POST "https://web3.nodit.io/v1/tron/mainnet/asset/searchAssetMetadataByKeyword" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "USDT",
  "page": 1,
  "rpp": 10,
  "withCount": false
}'
Response
Example · 200
{
  "page": 0,
  "rpp": 0,
  "cursor": "string",
  "count": 0,
  "items": [
    {
      "id": 1002357,
      "name": "GMCoin",
      "symbol": "GMC",
      "totalSupply": "8000000000",
      "decimals": 2,
      "startTime": 1556658000000,
      "endTime": 1561928340000,
      "description": "GM Informatic Technologies Token",
      "url": "https://gmc.gm-informatics.com",
      "deployer": "TTzC9cm1vbsyBzhC8n4z3k6eAVkryDyKU8",
      "blockNumber": 8663035,
      "blockTimestamp": 1556139189000,
      "transactionHash": "593d6376a1addee248d4f9588cfcb5938fcd8a97d75349650cca64da363d4bd2",
      "trxNum": 7000000,
      "num": 1000
    }
  ]
}