获取账户代币资产价值
1. 概述与典型用途
返回账户持有某代币随时间变化的每日价格、余额及 USD 价值。
- 典型用途:绘制账户某代币持仓价值变化趋势图。
- 何时不要用:查看余额流向请用「获取账户代币余额流向」。
2. 接口与鉴权
GET /api/account/holderToken/asset/valueInfo
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
accountAddress | string | 是 | — | 查询的账户地址 |
tokenAddress | string | 是 | — | TRC20 地址或 TRC10 代币 ID,TRX 使用 0 |
startTime | integer | 否 | — | 开始时间,精确到毫秒 |
endTime | integer | 否 | 当前时间 | 结束时间,精确到毫秒 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
data | array | 必返 | 每日价值数据列表 | — |
tokenDecimal | integer | 必返 | 代币精度 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | string | 必返 | 日期 | yyyy-MM-dd |
statistics | object | 必返 | 当日统计数据 | — |
statistics 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | string | 必返 | 日期 | yyyy-MM-dd |
balance | string | 必返 | 余额(最小单位) | — |
price | string | 必返 | 单价 | 美元 |
value | string | 必返 | 总价值 | 美元 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 通用错误处理规则适用,无特殊错误场景。
最后更新于: