Get TRC20/TRC721/TRC1155 Token Details
1. Overview & Typical Use
Returns detailed information for TRC20/TRC721/TRC1155 tokens, including name, issuer, holder count, 24-hour trading volume, market data, and price trend.
- Typical use: token detail page display, price trend chart, basic token info queries.
- When not to use: for TRC10 tokens use “Get TRC10 Token Details”; for token price only use “Get Token Price”.
2. Endpoint & Authentication
GET /api/token_trc20
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contract | string | Yes | — | TRC20/TRC721/TRC1155 contract address; omitting returns {"message":"contract address is missing"} |
showAll | integer | No | 0 | Data type to return. 0: whitelist only, 1: all, 2: exclude blacklist |
start | integer | No | 0 | Start index |
limit | integer | No | 30 | Items per page, max 50 |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Number of hits | — |
rangeTotal | integer | Required | Total count within the filtered range | — |
contractMap | object | Required | Address → whether the address is a contract (includes contract and issuer addresses) | — |
trc20_tokens | array | Required | Token details array | — |
trc20_tokens[] elements
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
symbol | string | Required | Token abbreviation | — |
name | string | Required | Token name | — |
contract_address | string | Required | Contract address | — |
contract_name | string | Required | Contract deployment name | — |
issue_address | string | Required | Issuer address | — |
issue_time | string | Required | Issue time (string format) | — |
issue_ts | integer | Required | Issue timestamp; always 0 in practice (not populated by backend) — use issue_time (string) or date_created (Unix seconds) for the actual issue time | seconds timestamp |
date_created | integer | Required | Creation timestamp | seconds timestamp |
decimals | integer | Required | Decimal places | — |
total_supply | number | Required | Total supply (converted) | includes decimals |
total_supply_with_decimals | string | Required | Total supply raw value (big-number string) | — |
total_supply_str | string | Required | Total supply backup string; always empty string in practice (not populated by backend) — use total_supply_with_decimals for the raw value | — |
holders_count | integer | Required | Total number of holders | — |
transfer_num | integer | Required | Cumulative transfer count | — |
transfer24h | integer | Required | 24-hour transfer count | — |
transfer24h_rate | number | Required | 24-hour transfer volume change rate | decimal |
totalTurnOver | string | Required | Cumulative circulation raw value | — |
totalTurnOverInUsd | string | Required | Cumulative circulation in USD | — |
volume | string | Required | 24-hour trading volume (USD string, may be "0" or empty) | USD |
volume24h | number | Required | 24-hour trading volume (TRX) | TRX |
volume24h_rate | number | Required | 24-hour trading volume change rate | decimal |
market_cap_usd | string | Required | Market cap (USD) | — |
gain | string | Required | Top-level 24h price change (string); empty string "" when no DEX price; use market_info.gain (number) for actual data | decimal percent |
price | string | Required | Token price (string, may be empty) | — |
price_trx | number | Required | TRX-denominated price (may be 0) | TRX |
vip | boolean | Required | Whether this is a VIP token | — |
level | string | Required | Token level | — |
icon_url | string | Required | Token logo URL | — |
inTvcToken | boolean | Required | Whether in the TVC token list | — |
specific_token | boolean | Required | Whether this is a special token | — |
symbolShow | boolean | Required | Whether to show in list | — |
fromThirdParty | boolean | Required | Whether data is from a third party | — |
home_page | string | Required | Project home page URL (may be empty string) | — |
white_paper | string | Required | Whitepaper URL (may be empty string) | — |
git_hub | string | Required | GitHub link (may be empty string) | — |
email | string | Required | Contact email (may be empty string) | — |
social_media | string | Required | Social media info (may be empty string) | — |
social_media_list | array | Required | Social media list (may be empty array) | — |
announcement | string | Required | Announcement content (may be empty string) | — |
token_desc | string | Required | Token description | — |
tokenType | string | Required | Token type (trc20 / trc721 / trc1155) | — |
redTag | string | Required | Risk tag (may be empty string) | — |
greyTag | string | Required | Grey tag (may be empty string) | — |
blueTag | string | Required | Blue tag (may be empty string) | — |
publicTag | string | Required | Public tag (may be empty string) | — |
index | integer | Required | Rank index | — |
liquidity24h | number | Required | 24-hour liquidity | — |
liquidity24h_rate | number | Required | 24-hour liquidity change rate | decimal |
justSwapVolume24h | number | Required | JustSwap 24-hour trading volume | — |
justSwapVolume24h_rate | number | Required | JustSwap 24-hour volume change rate | decimal |
tokenPriceLine | object | Required | Price trend chart data; contains total (integer) and data[] (array), each element has time (ms timestamp) + priceUsd (number) | — |
tab_circulating_supply | string | Optional | Circulating supply (big-number string with decimals); returned for some tokens (e.g. TUSD / BTT / JST), not returned for USDT etc. | includes decimals |
market_info | object | Optional | Market info (only for tokens with a DEX market price); sub-fields: priceInTrx (number), priceInUsd (string), gain (number, 24h change), liquidity (number), volume24hInTrx (number), volume24hGain (number), priceFrom (string, price source, e.g. SUNSWAPV2), pairUrl (string, pair URL), filter (string, filter), fTokenAddr / sTokenAddr (pair token addresses), fShortName / sShortName (pair token abbreviations), fPrecision / sPrecision (pair token precisions) | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
contractis a required parameter: omitting it returns{"message":"contract address is missing"}.limitcap is 50: excess is silently truncated, no error is returned.- Empty result is not an error: no matches returns
200+trc20_tokens: []— this is a normal response.
Last updated on: