Get TRC10 Token Details
1. Overview & Typical Use
Returns detailed information for TRC10 tokens, including name, issuer, holder count, market data, and price trend.
- Typical use: TRC10 token detail page display, token search, token list aggregation.
- When not to use: for TRC20/TRC721/TRC1155 tokens use “Get TRC20/TRC721/TRC1155 Token Details”.
2. Endpoint & Authentication
GET /api/token
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start | integer | No | 0 | Start index |
limit | integer | No | 10 | Items per page |
id | integer | No | — | TRC10 token ID; set to 0 for TRX |
owner | string | No | — | TRC10 issuer address |
name | string | No | — | TRC10 token name |
showAll | integer | No | 0 | Data type to return. 0: whitelist only, 1: all, 2: exclude blacklist |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Total count under current filter | — |
totalAll | integer | Required | Total count of all tokens | — |
contractMap | object | Required | Address → whether the address is a contract | — |
data | array | Required | Token list | — |
data[] elements
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
tokenID | integer | Required | TRC10 token ID | — |
id | integer | Required | Same as tokenID (alias field) | — |
name | string | Required | Token name | — |
abbr | string | Required | Token abbreviation | — |
precision | integer | Required | Decimal places | — |
totalSupply | string | Required | Total supply (string) | — |
availableSupply | number | Required | Available supply | — |
issued | number | Required | Amount issued | — |
issuedPercentage | number | Required | Issued percentage | percent |
remaining | number | Required | Remaining issuable amount | — |
remainingPercentage | number | Required | Remaining percentage | — |
frozenTotal | number | Required | Total frozen amount | — |
frozenPercentage | number | Required | Frozen percentage | — |
nrOfTokenHolders | integer | Required | Number of holders | — |
ownerAddress | string | Required | Issuer address | — |
vip | boolean | Required | Whether this is a VIP token | — |
level | string | Required | Token level: 0 (UNKNOWN), 1 (NEUTRAL), 2 (OK), 3 (SUSPICIOUS), 4 (UNSAFE) | — |
imgUrl | string | Required | Token logo URL (may be empty string) | — |
canShow | string | Required | Whether to display ("1" yes, "0" no) | — |
isBlack | boolean | Required | Whether this is a blacklisted token | — |
price | number | Required | Token price (TRX exchange rate set at TRC10 issuance, in sun) | sun |
trxNum | number | Required | TRX amount per unit of token (sun) | sun |
num | number | Required | Number of tokens per group | — |
dateCreated | integer | Required | Issuance timestamp | Millisecond timestamp |
startTime | integer | Required | ICO start time | Millisecond timestamp |
endTime | integer | Required | ICO end time | Millisecond timestamp |
participated | integer | Required | TRX amount that participated in ICO | sun |
totalTurnOver | string | Required | Cumulative circulation | — |
index | integer | Required | Rank index | — |
rank_order | integer | Required | Market cap rank | — |
reputation | string | Required | Reputation status (e.g. "Ok" / "Unknown") | — |
symbolShow | boolean | Required | Whether to show token symbol | — |
country | string | Required | Issuance region (may be empty string) | — |
description | string | Required | Token description | — |
website | string | Required | Project website (may be empty string) | — |
url | string | Required | Project URL (may be empty string) | — |
white_paper | string | Required | Whitepaper link (may be empty string) | — |
github | string | Required | GitHub link (may be empty string) | — |
email | string | Required | Contact email (may be empty string) | — |
announcement | string | Required | Announcement content (may be empty string) | — |
social_media | array | Required | Social media list (may be empty array) | — |
new_social_media | string | Required | New social media field (may be empty string) | — |
voteScore | number | Required | Vote score | — |
fromThirdParty | boolean | Required | Whether data is from a third party | — |
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) | — |
frozen | array | Required | Frozen supply details (expanded when frozen_supply has content) | — |
frozen_supply | array | Required | Frozen supply configuration (may be empty array) | — |
tokenPriceLine | object | Required | Price trend data (contains total and data array) | — |
thirdPartyUrl | string | Required | Third-party URL (may be empty string) | — |
market_cap_usd | number | Optional | Token market cap in USD; code-derived from Greason v5 scan, likely returned only for tokens with price data (reproducing sample pending) | USD |
totalTransactions | integer | Optional | Total transaction count for this token; code-derived from Greason v5 scan (reproducing sample pending) | — |
transfer24h_rate | number | Optional | 24-hour transfer volume change rate; code-derived from Greason v5 scan (reproducing sample pending) | — |
volume24h_rate | number | Optional | 24-hour trading volume change rate; code-derived from Greason v5 scan (reproducing sample pending) | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- Empty result is not an error: no matches returns
200+data: []— this is a normal response.
Last updated on: