获取账户代币余额流向
1. 概述与典型用途
返回截止至指定结束时间,账户某代币余额的变化流向(流入和流出)。
- 典型用途:分析账户某代币资金进出变化。
- 何时不要用:查看价值变化趋势请用「获取账户代币资产价值」。
2. 接口与鉴权
GET /api/account/holderToken/asset/changeBalance
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
accountAddress | string | 是 | — | 查询的账户地址 |
tokenAddress | string | 是 | — | TRC20 地址或 TRC10 代币 ID,TRX 使用 0 |
endTime | integer | 否 | 当前时间 | 结束时间,精确到毫秒 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
data | array | 必返 | 余额变化列表 | — |
tokenDecimal | integer | 必返 | 代币精度 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | integer | 必返 | 日期时间戳 | 秒(10 位) |
statistics | object | 必返 | 当日统计数据 | — |
statistics 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | integer | 必返 | 日期时间戳 | 秒(10 位) |
change | string | 必返 | 余额变化量(最小单位) | — |
balance | string | 必返 | 当日余额(最小单位) | — |
type | integer | 必返 | 变化类型:1 流入,2 流出 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 通用错误处理规则适用,无特殊错误场景。
最后更新于: