获取稳定币流动性池分布
1. 概述与典型用途
返回包含指定稳定币的所有流动性池（SunSwap v1/v2、SunCurve），包括 TVL 和代币构成。
- 典型用途：查看某稳定币在各 DEX 的流动性分布。
- 何时不要用：查询所有流动性池的概览用「获取所有稳定币流动性池信息」。
2. 接口与鉴权
GET /api/stableCoin/tvl
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
token | string | 否 | — | 稳定币合约地址；不传则返回所有 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
sunswapv1 | array | 必返 | SunSwap V1 池列表 | — |
sunswapv2 | array | 必返 | SunSwap V2 池列表 | — |
sun | array | 必返 | SunCurve 池列表 | — |
各池数组元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
poolAddress | string | 必返 | 流动性池合约地址 | — |
poolName | string | 必返 | 池名称 | — |
project | string | 必返 | 项目名称 | — |
liquidity | string | 必返 | 池流动性（原生单位，非 USD） | 代币单位 |
tvl | string | 必返 | 总锁仓量 | USD |
volume24Hours | string | 可选 | 24 小时交易量 | USD |
tokens | array | 必返 | 池中代币详情数组 | — |
tokens[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenId | string | 必返 | 代币合约地址 | — |
tokenAbbr | string | 必返 | 代币缩写 | — |
tokenName | string | 必返 | 代币名称 | — |
tokenDecimal | integer | 必返 | 代币精度 | — |
tokenType | string | 必返 | 代币类型（trc20/trc10 等） | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
issuerAddr | string | 必返 | 代币发行方地址 | — |
tokenLogo | string | 必返 | 代币图标 URL | — |
tokenLevel | string | 必返 | 代币等级：0（UNKNOWN，未知）、1（NEUTRAL，中性）、2（OK，正常）、3（SUSPICIOUS，可疑）、4（UNSAFE，不安全） | — |
tokenCanShow | integer | 必返 | 是否可展示（1 可展示） | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果不等于错误：无流动性池时各数组为空，属于正常响应。
最后更新于: