获取稳定币发行量变化
1. 概述与典型用途
返回指定时间范围内各稳定币的每日供应量记录。
- 典型用途：按各币种精度换算供应量，绘制各稳定币发行量变化趋势图。
- 何时不要用：查询单个稳定币流通量趋势请用「获取稳定币流通量趋势」。
2. 接口与鉴权
GET /api/stableCoin/totalSupply/change
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
startTime | integer | 否 | — | 统计日期范围起点（含），按 category[].date 筛选；Unix 毫秒时间戳 |
endTime | integer | 否 | 当前时间 | 统计日期范围终点（含），按 category[].date 筛选；Unix 毫秒时间戳 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
statistics | array | 必返 | 每日供应量变化列表 | — |
statistics[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | integer | 必返 | 统计日结束边界：category[].date 次日的 UTC 00:00；例如 2023-04-03 对应 1680566400（2023-04-04 00:00 UTC） | 秒 |
total | string | 必返 | 历史原始值汇总，等于当日 category[].totalSupply 直接相加；混合不同币种精度，不可直接用于总量展示，也不能解释为统一的代币数量或 USD 市值 | 混合精度，无统一单位 |
category | array | 必返 | 各币种供应量详情 | — |
category[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | string | 必返 | 该币种供应量记录的统计日期，用于查询范围筛选；statistics[].date 对应该日期次日的 UTC 零点 | yyyy-MM-dd |
tokenName | string | 必返 | 代币名称 | — |
address | string | 必返 | 代币合约地址 | — |
decimal | integer | 必返 | 代币精度 | — |
totalSupply | string | 必返 | 该代币原始供应量。代币数量 = totalSupply / 10^decimal；美元估值还需乘以该币同一统计日的 USD 价格，本接口不返回价格 | 该代币最小单位 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 通用错误处理规则适用，无特殊错误场景。