获取 TRC10 代币详细信息
1. 概述与典型用途
返回 TRC10 代币的详细信息，包括名称、发行方、持有者数量、市场行情及价格走势。
- 典型用途：TRC10 代币详情页展示、代币搜索、代币列表聚合。
- 何时不要用：查询 TRC20/TRC721/TRC1155 代币用「获取 TRC20/TRC721/TRC1155 代币详细信息」。
2. 接口与鉴权
GET /api/token
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
start | integer | 否 | 0 | 起始编号 |
limit | integer | 否 | 10 | 每页数量 |
id | integer | 否 | — | TRC10 代币 ID，设置为 0 时表示 TRX |
owner | string | 否 | — | TRC10 发行方地址 |
name | string | 否 | — | TRC10 代币名称 |
showAll | integer | 否 | 0 | 返回数据类型。0：仅白名单，1：全部，2：排除黑名单 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 当前过滤条件下总数 | — |
totalAll | integer | 必返 | 全部代币总数 | — |
contractMap | object | 必返 | 地址 → 是否为合约的映射 | — |
data | array | 必返 | 代币列表 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenID | integer | 必返 | TRC10 代币 ID | — |
id | integer | 必返 | 同 tokenID（别名字段） | — |
name | string | 必返 | 代币名称 | — |
abbr | string | 必返 | 代币缩写 | — |
precision | integer | 必返 | 精度位数 | — |
totalSupply | string | 必返 | 总供应量（字符串） | — |
availableSupply | number | 必返 | 可用供应量 | — |
issued | number | 必返 | 已发行数量 | — |
issuedPercentage | number | 必返 | 已发行占比 | 百分比 |
remaining | number | 必返 | 剩余可发行量 | — |
remainingPercentage | number | 必返 | 剩余占比 | — |
frozenTotal | number | 必返 | 冻结总量 | — |
frozenPercentage | number | 必返 | 冻结占比 | — |
available | number | 必返 | 可流通数量（与 availableSupply 语义对齐，实测多为 0） | — |
percentage | number | 必返 | 可流通占比（与 issuedPercentage 等系列共存的别名/补充字段，实测多为 0） | 百分比 |
nrOfTokenHolders | integer | 必返 | 持有者数量 | — |
ownerAddress | string | 必返 | 发行方地址 | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
level | string | 必返 | 代币等级 | — |
imgUrl | string | 必返 | 代币 Logo URL（可为空字符串） | — |
canShow | string | 必返 | 是否显示（"1" 显示，"0" 不显示） | — |
isBlack | boolean | 必返 | 是否为黑名单代币 | — |
price | number | 必返 | 代币定价（TRC10 发行时设定的 TRX 换算价，单位 sun） | sun |
trxNum | number | 必返 | 每单位代币对应的 TRX 数量（sun） | sun |
num | number | 必返 | 每组代币数量 | — |
dateCreated | integer | 必返 | 发行时间戳 | 毫秒时间戳 ms |
startTime | integer | 必返 | ICO 开始时间 | 毫秒时间戳 ms |
endTime | integer | 必返 | ICO 结束时间 | 毫秒时间戳 ms |
participated | integer | 必返 | 参与 ICO 的 TRX 数量 | sun |
totalTurnOver | string | 必返 | 累计流通量 | — |
index | integer | 必返 | 排列序号 | — |
rank_order | integer | 必返 | 市值排名 | — |
reputation | string | 必返 | 信誉状态（如 "Ok" / "Unknown"） | — |
symbolShow | boolean | 必返 | 是否显示代币符号 | — |
country | string | 必返 | 发行地区（可为空字符串） | — |
description | string | 必返 | 代币描述 | — |
website | string | 必返 | 项目网址（可为空字符串） | — |
url | string | 必返 | 项目 URL（可为空字符串） | — |
white_paper | string | 必返 | 白皮书链接（可为空字符串） | — |
github | string | 必返 | GitHub 链接（可为空字符串） | — |
email | string | 必返 | 联系邮箱（可为空字符串） | — |
announcement | string | 必返 | 公告内容（可为空字符串） | — |
social_media | array | 必返 | 社交媒体列表（可为空数组） | — |
new_social_media | string | 必返 | 新社交媒体字段（可能为空字符串） | — |
voteScore | number | 必返 | 投票得分 | — |
fromThirdParty | boolean | 必返 | 数据是否来自第三方 | — |
redTag | string | 必返 | 风险标签（可能为空字符串） | — |
greyTag | string | 必返 | 灰色标签（可能为空字符串） | — |
blueTag | string | 必返 | 蓝色标签（可能为空字符串） | — |
publicTag | string | 必返 | 公共标签（可能为空字符串） | — |
frozen | array | 必返 | 冻结供应明细（frozen_supply 有内容时展开） | — |
frozen_supply | array | 必返 | 冻结供应配置（可为空数组） | — |
tokenPriceLine | object | 必返 | 价格走势图数据（含 total 和 data 数组） | — |
thirdPartyUrl | string | 必返 | 第三方 URL（可为空字符串） | — |
market_cap_usd | number | 可选 | 代币市值（USD）；基于 Greason v5 代码扫描，可能仅有价格数据的代币返回（待补 reproducing sample） | USD |
totalTransactions | integer | 可选 | 代币相关的总交易数；基于 Greason v5 代码扫描（待补 reproducing sample） | — |
transfer24h_rate | number | 可选 | 近 24 小时转账量环比变化率；基于 Greason v5 代码扫描（待补 reproducing sample） | — |
volume24h_rate | number | 可选 | 近 24 小时交易量环比变化率；基于 Greason v5 代码扫描（待补 reproducing sample） | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果 ≠ 错误：无命中返回
200+data: []，属于正常响应。
最后更新于: