获取稳定币持有量排行
1. 概述与典型用途
返回持有量排名前 50 的稳定币持有者及其 USDT、USDC、USDD、TUSD 和 USDJ 余额。
- 典型用途：展示稳定币大户排行榜。
- 何时不要用：查询单个账户详情请用账户接口。
2. 接口与鉴权
GET /api/stableCoin/holder/top
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
viewContract | integer | 否 | 1 | 是否包含合约数据。1：包含，2：不包含 |
sort | string | 否 | USDT | 排序字段：USDT、USDC、USDJ、USDD 或 TUSD |
direction | integer | 否 | 2 | 排序方向。1：升序，2：降序 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 返回条数（固定 50） | — |
data | array | 必返 | 持有者列表 | — |
contractMap | object | 必返 | 地址是否为合约的映射 | — |
refreshTimeInfo | object | 必返 | 数据刷新信息，含 type（"realtime"）和 lastUpdateTime（秒时间戳） | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
address | string | 必返 | 持有者地址 | — |
addressType | integer | 必返 | 地址类型 | — |
accountTag | string | 必返 | 账户标签（无标签账户返回空字符串 ""） | — |
usdtAmount | number | 必返 | USDT 持有量 | 美元 |
tusdAmount | number | 可选 | TUSD 持有量（仅持有非零 TUSD 的账户返回） | 美元 |
usddAmount | number | 可选 | USDD 持有量（仅持有非零 USDD 的账户返回） | 美元 |
usdcoldAmount | number | 可选 | USDC 持有量（仅持有非零 USDC 的账户返回；字段名以 old 结尾源自历史合约命名） | 美元 |
usdjAmount | number | 可选 | USDJ 持有量（仅持有非零 USDJ 的账户返回） | 美元 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 通用错误处理规则适用，无特殊错误场景。
最后更新于: