获取 TRC20/TRC721/TRC1155 代币详细信息
1. 概述与典型用途
返回 TRC20/TRC721/TRC1155 代币的详细信息，包括名称、发行方、持有者数量、24 小时交易量、市场行情及价格走势。
- 典型用途：代币详情页展示、价格走势图、代币基本信息查询。
- 何时不要用：查询 TRC10 代币用「获取 TRC10 代币详细信息」；仅需代币价格用「获取指定代币价格信息」。
2. 接口与鉴权
GET /api/token_trc20
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
contract | string | 是 | — | TRC20/TRC721/TRC1155 合约地址；不传返回 {"message":"contract address is missing"} |
showAll | integer | 否 | 0 | 返回数据类型。0：仅白名单，1：全部，2：排除黑名单 |
start | integer | 否 | 0 | 起始编号 |
limit | integer | 否 | 30 | 每页数量，最大 50 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 命中总数 | — |
rangeTotal | integer | 必返 | 过滤范围内总数 | — |
contractMap | object | 必返 | 地址 → 是否为合约的映射（含合约地址与发行方地址） | — |
trc20_tokens | array | 必返 | 代币详情数组 | — |
trc20_tokens[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
symbol | string | 必返 | 代币缩写 | — |
name | string | 必返 | 代币名称 | — |
contract_address | string | 必返 | 合约地址 | — |
contract_name | string | 必返 | 合约部署名称 | — |
issue_address | string | 必返 | 发行方地址 | — |
issue_time | string | 必返 | 发行时间（字符串格式） | — |
issue_ts | integer | 必返 | 发行时间戳；实测值永远为 0（后端未填充），真实发行时间请用 issue_time（字符串）或 date_created（Unix 秒） | 秒时间戳 |
date_created | integer | 必返 | 创建时间戳 | 秒时间戳 |
decimals | integer | 必返 | 精度位数 | — |
total_supply | number | 必返 | 总供应量（已换算） | 含 decimals |
total_supply_with_decimals | string | 必返 | 总供应量原值（大数字符串） | — |
total_supply_str | string | 必返 | 总供应量字符串备用；实测值永远为空字符串（后端未填充），真实原值请用 total_supply_with_decimals | — |
holders_count | integer | 必返 | 持有者总数 | — |
transfer_num | integer | 必返 | 累计转账次数 | — |
transfer24h | integer | 必返 | 24 小时转账次数 | — |
transfer24h_rate | number | 必返 | 24 小时转账量变化率 | 小数 |
totalTurnOver | string | 必返 | 累计流通量原值 | — |
totalTurnOverInUsd | string | 必返 | 累计流通量折合 USD | — |
volume | string | 必返 | 24 小时成交量（USD 字符串，可能为 "0" 或空） | USD |
volume24h | number | 必返 | 24 小时交易量（TRX） | TRX |
volume24h_rate | number | 必返 | 24 小时交易量变化率 | 小数 |
market_cap_usd | string | 必返 | 市值（USD） | — |
gain | string | 必返 | 顶层 24 小时涨跌幅（字符串）；无 DEX 价格时为空字符串 ""；有行情数据时以 market_info.gain（number）为准 | 百分比小数 |
price | string | 必返 | 代币价格（字符串，可能为空） | — |
price_trx | number | 必返 | TRX 计价（可能为 0） | TRX |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
level | string | 必返 | 代币等级 | — |
icon_url | string | 必返 | 代币 Logo URL | — |
inTvcToken | boolean | 必返 | 是否在 TVC 代币列表中 | — |
specific_token | boolean | 必返 | 是否为特殊代币 | — |
symbolShow | boolean | 必返 | 是否在列表中显示 | — |
fromThirdParty | boolean | 必返 | 数据是否来自第三方 | — |
home_page | string | 必返 | 项目主页 URL（可能为空字符串） | — |
white_paper | string | 必返 | 白皮书 URL（可能为空字符串） | — |
git_hub | string | 必返 | GitHub 链接（可能为空字符串） | — |
email | string | 必返 | 联系邮箱（可能为空字符串） | — |
social_media | string | 必返 | 社交媒体信息（可能为空字符串） | — |
social_media_list | array | 必返 | 社交媒体列表（可为空数组） | — |
announcement | string | 必返 | 公告内容（可能为空字符串） | — |
token_desc | string | 必返 | 代币描述 | — |
tokenType | string | 必返 | 代币类型（trc20 / trc721 / trc1155） | — |
redTag | string | 必返 | 风险标签（可能为空字符串） | — |
greyTag | string | 必返 | 灰色标签（可能为空字符串） | — |
blueTag | string | 必返 | 蓝色标签（可能为空字符串） | — |
publicTag | string | 必返 | 公共标签（可能为空字符串） | — |
index | integer | 必返 | 排列序号 | — |
liquidity24h | number | 必返 | 24 小时流动性 | — |
liquidity24h_rate | number | 必返 | 24 小时流动性变化率 | 小数 |
justSwapVolume24h | number | 必返 | JustSwap 24 小时交易量 | — |
justSwapVolume24h_rate | number | 必返 | JustSwap 24 小时交易量变化率 | 小数 |
tokenPriceLine | object | 必返 | 价格走势图数据；含 total（integer）与 data[]（数组），每元素 time（毫秒时间戳）+ priceUsd（number） | — |
tab_circulating_supply | string | 可选 | 流通量（带精度大数字符串）；部分代币返回（如 TUSD / BTT / JST），USDT 等不返回 | 含 decimals |
market_info | object | 可选 | 市场信息（有 DEX 市价的代币才有）；子字段：priceInTrx（number）、priceInUsd（string）、gain（number，24h 涨跌幅）、liquidity（number）、volume24hInTrx（number）、volume24hGain（number）、priceFrom（string，报价来源，如 SUNSWAPV2）、pairUrl（string，交易对 URL）、filter（string，过滤器）、fTokenAddr / sTokenAddr（pair token 地址）、fShortName / sShortName（pair token 缩写）、fPrecision / sPrecision（pair token 精度） | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
contract为必填参数：不传返回{"message":"contract address is missing"}。limit上限为 50：超出时被静默截断，不会返回错误。- 空结果 ≠ 错误：未命中返回
200+trc20_tokens: []，属于正常响应。
最后更新于: