获取指定代币价格信息
1. 概述与典型用途
返回指定代币的当前价格信息,包括 USD 与 TRX 计价、24 小时涨跌幅、市值及交易量。
- 典型用途:实时行情展示、价格监控、汇率换算。
- 何时不要用:批量获取代币价格用「获取有价格的代币列表」。
2. 接口与鉴权
GET /api/token/price
Base URL 与鉴权见 公共网络与鉴权说明。
本接口强制需要 API Key:无 Key 调用返回 401。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
token | string | 否 | trx | 代币缩写 |
4. 响应
字段
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
token | string | 必返 | 代币缩写 | — |
price_in_trx | string | 必返 | TRX 计价 | — |
price_in_usd | string | 必返 | USD 计价 | — |
percent_change_24h | string | 必返 | 24 小时价格变化百分比 | 百分比 |
volume_percent_change_24h | string | 必返 | 24 小时交易量变化百分比 | 百分比 |
market_cap | string | 必返 | 市值(USD) | — |
market_cap_percent_change_24h | string | 必返 | 24 小时市值变化百分比 | 百分比 |
volume_24h | string | 必返 | 24 小时交易量(USD) | — |
rank | integer | 必返 | 代币市值排名 | — |
from | string | 必返 | 数据来源 | — |
time | integer | 必返 | 数据时间 | 毫秒时间戳 ms |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 需要 API Key:未携带时返回
401。 - 代币不存在:无效的
token参数返回空响应。
最后更新于: