获取稳定币持有者分布
1. 概述与典型用途
返回稳定币在交易所、钱包及 DeFi 协议（JustLend、SunSwap、SunCurve 等）中的详细持有分布。
- 典型用途：展示稳定币持有者的当前分布快照。
- 何时不要用：查看分布随时间变化请用「获取稳定币持仓变化」。
2. 接口与鉴权
GET /api/stableCoin/distribution
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
token | string | 是 | — | 稳定币合约地址 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
addresses | object | 必返 | 地址类别分布（含 exchange、otherAccount 子类，加上聚合 percent / value） | — |
contract | object | 必返 | 合约类别分布（含 JustLend、SunSwap、SunCurve、otherContract 子类，加上聚合 percent / value） | — |
tokenName | string | 必返 | 代币名称 | — |
tokenAbbr | string | 必返 | 代币缩写 | — |
tokenDecimal | integer | 必返 | 代币精度 | — |
addresses / contract 顶层聚合字段（与各子类同级）
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
percent | string | 必返 | 该类（地址/合约）的总占比 | 小数 |
value | string | 必返 | 该类（地址/合约）的总持有量（最小单位） | 最小单位（除以 10^tokenDecimal） |
addresses.exchange / addresses.otherAccount
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
data | array | 必返 | 各地址占比详情 | — |
percent | string | 必返 | 总占比 | 小数 |
value | string | 必返 | 总持有量（最小单位） | 最小单位（除以 10^tokenDecimal） |
data[] 元素（地址列表）
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
address | string | 必返 | 地址或交易所名称 | — |
percent | string | 必返 | 占比 | 小数 |
value | string | 必返 | 持有量（最小单位） | 最小单位（除以 10^tokenDecimal） |
contract.JustLend / contract.SunSwap / contract.SunCurve / contract.otherContract
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
data | array | 必返 | 各合约地址占比详情 | — |
percent | string | 必返 | 占比 | 小数 |
value | string | 必返 | 持有量（最小单位） | 最小单位（除以 10^tokenDecimal） |
contract.*.data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
address | string | 必返 | 合约地址 | — |
percent | string | 必返 | 占比 | 小数 |
value | string | 必返 | 持有量（最小单位） | 最小单位（除以 10^tokenDecimal） |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 通用错误处理规则适用，无特殊错误场景。
最后更新于: