获取代币链上总价值（TVC）
1. 概述与典型用途
返回代币的链上总价值，包括各代币市值、价格及持有者信息。
- 典型用途：查看 TRON 链上代币总锁仓价值、各代币市值排名。
- 何时不要用：查看单个代币的转账分析用「获取代币交易数据」。
2. 接口与鉴权
GET /api/tokenTvc
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
startTime | integer | 否 | 7 天前 | 开始时间，精确到秒 |
endTime | integer | 否 | 当前时间 | 结束时间，精确到秒 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tvcLine | array | 必返 | TVC 趋势线数据，含 value（USD）和 time（秒时间戳）字段 | — |
stableCoinCountOfTopTen | integer | 必返 | Top 10 中稳定币数量 | — |
totalTokenNum | integer | 必返 | 纳入统计的代币总数 | — |
lastWeekTokenNum | integer | 可选 | 上周纳入统计的代币总数（可能为 0） | — |
totalTvc | number | 必返 | 当前 TVC 总额 | USD |
updateTime | integer | 必返 | 数据更新时间 | 毫秒时间戳 |
tokens | array | 必返 | 代币详情列表，见下 | — |
tokens[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
abbr | string | 必返 | 代币缩写 | — |
name | string | 必返 | 代币名称 | — |
contractAddress | string | 可选 | 代币合约地址（Base58Check 格式） | — |
contractAddressLower | string | 可选 | 代币合约地址（小写 hex 格式） | — |
tokenType | string | 可选 | 代币类型 | — |
priceInTrx | number | 可选 | 以 TRX 计价的价格 | TRX |
supply | number | 可选 | 总供应量 | — |
decimal | integer | 可选 | 代币精度 | — |
nrOfTokenHolders | integer | 可选 | 持有者数量 | — |
transferCount | integer | 可选 | 转账次数 | — |
recentTransferCount | integer | 可选 | 最近转账次数 | — |
volume24hInTrx | number | 可选 | 24 小时交易量（TRX） | TRX |
volume24hInUsd | number | 可选 | 24 小时交易量（USD） | USD |
gain | number | 可选 | 涨跌幅 | — |
marketcap | number | 可选 | 市值（TRX） | TRX |
marketCapUSD | number | 必返 | 美元市值 | USD |
priceInUsd | number | 可选 | 美元价格 | USD |
imgUrl | string | 可选 | 代币图标 URL | — |
ownerAddress | string | 可选 | 发行方地址 | — |
issueTime | string | 可选 | 发行时间 | yyyy-MM-dd HH:mm:ss |
dateCreated | integer | 可选 | 创建时间 | 毫秒时间戳 |
isTop | boolean | 可选 | 是否为 Top 代币 | — |
vip | boolean | 可选 | 是否为 VIP 代币 | — |
level | string | 可选 | 代币等级：0（UNKNOWN，未知）、1（NEUTRAL，中性）、2（OK，正常）、3（SUSPICIOUS，可疑）、4（UNSAFE，不安全） | — |
publicTag | string | 可选 | 公开标签 | — |
blueTag | string | 可选 | 蓝色标签 | — |
greyTag | string | 可选 | 灰色标签 | — |
redTag | string | 可选 | 红色标签 | — |
verifier | string | 可选 | 认证者 | — |
pairUrl | string | 可选 | 交易对链接 | — |
description | string | 可选 | 代币描述 | — |
projectSite | string | 可选 | 项目官网 | — |
email | string | 可选 | 联系邮箱 | — |
whitePaper | string | 可选 | 白皮书链接 | — |
github | string | 可选 | GitHub 链接 | — |
socialMedia | array | 可选 | 社交媒体列表 | — |
announcement | string | 可选 | 公告链接 | — |
extra | object | 可选 | 额外信息 | — |
canShow | integer | 可选 | 是否可展示 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果不是错误：无命中返回
200+ 空数组，属于正常响应。
最后更新于: