获取稳定币池基本信息
1. 概述与典型用途
返回指定流动性池的资产构成、TVL、24 小时交易量以及各代币流动性占比。
- 典型用途：查看流动性池详情页面数据。
- 何时不要用：查询全部流动性池列表请用「获取稳定币流动性池信息」。
2. 接口与鉴权
GET /api/stableCoin/pool/overview
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
pool | string | 是 | — | 流动性池合约地址（仅支持平台白名单池；无效池返回 {}） |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokens | array | 必返 | 池中代币列表 | — |
volume24Hours | string | 必返 | 24 小时交易量 | 美元 |
tvl | string | 必返 | 当前总锁仓价值；与代币流动性分别刷新，可能不同于各代币 liquidity 之和 | USD |
poolUrl | string | 必返 | 池在 sun.io 的链接 | — |
tokens[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenId | string | 必返 | 代币合约地址；原生 TRX 为 _ | — |
tokenAbbr | string | 必返 | 代币缩写 | — |
tokenName | string | 必返 | 代币名称 | — |
tokenDecimal | integer | 必返 | 代币精度 | — |
tokenType | string | 必返 | 代币类型 | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
issuerAddr | string | 可选 | 代币发行方地址 | — |
tokenLogo | string | 可选 | 代币图标 URL | — |
tokenLevel | string | 可选 | 代币等级：0（UNKNOWN，未知）、1（NEUTRAL，中性）、2（OK，正常）、3（SUSPICIOUS，可疑）、4（UNSAFE，不安全） | — |
tokenCanShow | integer | 可选 | 是否可展示 | — |
liquidity | string | 必返 | 该代币当前流动性的美元价值 | USD |
liquidityPercent | string | 必返 | 同一快照中该代币占代币流动性总额的比例：liquidity / sum(tokens[].liquidity) | 0–1 小数，四舍五入保留 6 位 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 无效池地址：返回空对象
{}，不会报错。