获取持币账户数量变化
1. 概述与典型用途
返回各稳定币每日持有者数量及随时间变化的汇总总量。
- 典型用途:绘制稳定币持有者增长趋势图。
- 何时不要用:查询单个稳定币持有排名请用「获取稳定币持有量排行」。
2. 接口与鉴权
GET /api/stableCoin/holder/change
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
startDay | string | 否 | 30 天前 | 开始日期,格式:yyyy-MM-dd;最早:2020-12-11 |
endDay | string | 否 | 今日(UTC) | 结束日期,格式:yyyy-MM-dd;startDay 不得晚于 endDay |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
statistics | array | 必返 | 每日持有者变化列表 | — |
latest | array | 必返 | 最新各币种持有者数量 | — |
totalHolder | string | 必返 | 所有稳定币持有者总数 | — |
statistics[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | integer | 必返 | 日期时间戳 | 秒 |
aggrHolder | string | 必返 | 当日持有者总数 | — |
category | array | 必返 | 各币种持有者详情 | — |
category[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenName | string | 必返 | 代币名称 | — |
tokenAddress | string | 必返 | 代币合约地址 | — |
holderNum | string | 必返 | 持有者数量 | — |
date | string | 必返 | 日期 | yyyy-MM-dd |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
startDay晚于endDay:返回空数据。
最后更新于: