获取某稳定币流通量的趋势图表
1. 概述与典型用途
返回指定稳定币每日的总供应量、铸造量和销毁量。支持的稳定币：USDD、USDC、USDJ、TUSD。
- 典型用途：单个稳定币供应量变化分析、铸造/销毁历史追踪。
- 何时不要用：查询所有稳定币供应量变化用「获取所有稳定币发行量变化图表」。
2. 接口与鉴权
GET /api/stableCoin/tokenSupply/turnover
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
tokenAddress | string | 是 | — | 稳定币合约地址，支持 USDD、USDC、USDJ、TUSD |
startTime | integer | 否 | — | 开始时间，精确到秒；最早 2022-11-22 |
endTime | integer | 否 | 当前时间 | 结束时间，精确到秒 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
statistics | array | 必返 | 每日供应量数据数组 | — |
tokenDecimal | integer | 必返 | 代币精度 | — |
statistics[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | string | 必返 | 日期字符串，格式 yyyy-MM-dd | — |
totalSupply | string | 必返 | 当日总供应量（最小单位原始整数，大数以 string 返回防溢出） | decimals 见顶层 tokenDecimal |
mintAmount | number | 可选 | 当日铸造量（最小单位） | 最小单位 |
burnAmount | number | 可选 | 当日销毁量（最小单位） | 最小单位 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 不支持的代币地址：返回
{"message":"some parameters are invalid or out of range"}。 - 空结果不等于错误：无数据时返回
200+statistics: []，属于正常响应。
最后更新于: