获取代币列表
1. 概述与典型用途
查询全网代币列表，涵盖 TRC10、TRC20、TRC721、TRC1155 等类型，支持按市值、涨幅、交易量等多维度排序与过滤。
- 典型用途：代币排行榜展示、市值筛选、新代币发现。
- 何时不要用：查询单个 TRC20 代币详情用「获取 TRC20/TRC721/TRC1155 代币详细信息」；查询 TRC10 代币详情用「获取 TRC10 代币详细信息」。
2. 接口与鉴权
GET /api/tokens/overview
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
start | integer | 否 | 0 | 起始编号（偏移量） |
limit | integer | 否 | 20 | 每页数量，最大 500 |
order | string | 否 | desc | 排序方向：desc（降序）、asc（升序） |
filter | string | 否 | all | 代币类型过滤：trc10、trc20、trc721、trc1155、all、top |
sort | string | 否 | marketcap | 排序字段：priceInTrx、gain、volume24hInTrx、holderCount、marketcap、createTime、hot、init、top |
field | string | 否 | — | 返回的字段名称，以逗号分隔；为空时返回所有字段 |
verifier | string | 否 | — | 设置为 all 时返回包含 type=auto 的代币，默认不返回 |
showAll | integer | 否 | 0 | 返回数据类型。0：仅白名单，1：全部，2：排除黑名单 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 当前过滤条件下代币总数 | — |
totalAll | integer | 必返 | 含所有类型的代币总数（与 totalAllCount 相同） | — |
totalAllCount | integer | 必返 | 全网代币总数（含所有类型） | — |
all | integer | 必返 | 全网代币总数（与 totalAllCount 相同，保留向后兼容） | — |
total10 | integer | 必返 | TRC10 代币总数 | — |
total20 | integer | 必返 | TRC20 代币总数 | — |
total721 | integer | 必返 | TRC721 代币总数 | — |
total1155 | integer | 必返 | TRC1155 代币总数 | — |
currentWeekAll | integer | 必返 | 本周新增代币数（所有类型合计） | — |
currentWeekTotalAll | integer | 必返 | 本周新增代币数（另一统计口径） | — |
valueAtLeast | integer | 必返 | 有价值代币的最低阈值（USD） | USD |
tokens | array | 必返 | 代币列表 | — |
updateTime | integer | 必返 | 数据更新时间 | 毫秒时间戳 ms |
tokens[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
name | string | 必返 | 代币名称 | — |
abbr | string | 必返 | 代币缩写 | — |
contractAddress | string | 必返 | 合约地址（TRC10 为 _） | — |
tokenId | integer | 可选 | TRC10 代币 ID（TRC10 有，TRC20 无） | — |
ownerAddress | string | 可选 | 发行方地址（TRC10 为 -，TRC20 为实际地址） | — |
tokenType | string | 必返 | 代币类型（trc10 / trc20 / trc721 / trc1155） | — |
decimal | integer | 必返 | 精度位数 | — |
priceInTrx | number | 可选 | TRX 计价（有价格代币才有） | — |
priceInUsd | number | 可选 | USD 计价（有价格代币才有） | — |
marketcap | number | 可选 | 市值（TRX，有价格代币才有） | TRX |
marketCapUSD | number | 可选 | 市值（USD，有价格代币才有） | USD |
gain | number | 可选 | 24 小时涨跌幅（有行情代币才有） | 小数 |
volume24hInTrx | number | 可选 | 24 小时交易量（TRX，有行情代币才有） | TRX |
volume24hInUsd | number | 可选 | 24 小时交易量（USD，有行情代币才有） | USD |
supply | number | 可选 | 流通量 | — |
nrOfTokenHolders | integer | 必返 | 持有者数量 | — |
transferCount | integer | 必返 | 累计转账次数 | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
isTop | boolean | 可选 | 是否为置顶代币 | — |
verifier | string | 可选 | 验证来源（如 "robot"） | — |
level | string | 可选 | 代币等级：0（UNKNOWN，未知）、1（NEUTRAL，中性）、2（OK，正常）、3（SUSPICIOUS，可疑）、4（UNSAFE，不安全） | — |
canShow | integer | 可选 | 是否显示（1 显示，0 不显示） | — |
imgUrl | string | 可选 | 代币 Logo URL | — |
description | string | 可选 | 代币描述 | — |
github | string | 可选 | GitHub 链接 | — |
projectSite | string | 可选 | 项目官网 | — |
whitePaper | string | 可选 | 白皮书链接 | — |
socialMedia | string | 可选 | 社交媒体（JSON 字符串） | — |
pairUrl | string | 可选 | DEX 交易对 URL | — |
dateCreated | integer | 可选 | 创建时间戳 | 秒时间戳 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
limit上限为 500：超出时被静默截断至 500，不会返回错误。- 空结果 ≠ 错误：无命中返回
200+tokens: []，属于正常响应。
最后更新于: