获取 24h 转账金额变化
1. 概述与典型用途
返回稳定币随时间的转账金额,并可按代币返回折线图数据。
- 典型用途:展示稳定币 24 小时转账金额趋势图。
- 何时不要用:查询单笔转账详情请用交易查询接口。
2. 接口与鉴权
GET /api/stableCoin/transferAmount
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
startTime | integer | 否 | endTime - 7 天 | 开始时间,精确到秒 |
endTime | integer | 否 | 当前时间 | 结束时间,精确到秒 |
type | string | 否 | — | 设置为 addLine 时,响应中包含折线图数据 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
stableAmountLine | array | 必返 | 各代币折线图数据;lineData 条目数量因 type=addLine 而异 | — |
stableAmount24h | array | 必返 | 各代币 24 小时转账金额 | — |
stableAmountLine[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenAbbr | string | 必返 | 代币缩写 | — |
contractAddress | string | 必返 | 代币合约地址 | — |
lineData | array | 必返 | 折线图数据点;元素 schema 见下方 | — |
lineData[] 元素(折线图数据点)
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
t | integer | 必返 | 数据点时间 | 毫秒时间戳 |
v | number | 必返 | 该时间点转账金额 | 美元 |
stableAmount24h[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
amount24h | number | 必返 | 24 小时转账金额 | 美元 |
contractAddress | string | 必返 | 代币合约地址 | — |
tokenAbbr | string | 必返 | 代币缩写 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 通用错误处理规则适用,无特殊错误场景。
最后更新于: