获取流动性池的流动性变化图表
1. 概述与典型用途
返回指定流动性池地址的流动性历史变化记录，包括每日 TVL 和各代币流动性。
- 典型用途：流动性池 TVL 变化趋势图、代币构成变化分析。
- 何时不要用：查询池的资金流向用「获取流动性池变化趋势信息」。
2. 接口与鉴权
GET /api/stableCoin/pool/change
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
pool | string | 是 | — | 流动性池合约地址 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
count | integer | 必返 | 数据点总数 | — |
data | array | 必返 | 流动性变化数据数组 | — |
{tokenAddress} | object | 必返 | 以代币地址（或 _ 表示 TRX）为键的代币元信息 | — |
{tokenAddress} 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenId | string | 必返 | 代币合约地址（TRX 为 _） | — |
tokenAbbr | string | 必返 | 代币缩写 | — |
tokenName | string | 必返 | 代币名称 | — |
tokenDecimal | integer | 必返 | 代币精度 | — |
tokenCanShow | integer | 必返 | 是否可展示（1 可展示） | — |
tokenType | string | 必返 | 代币类型（trc20/trc10 等） | — |
tokenLogo | string | 必返 | 代币图标 URL | — |
tokenLevel | string | 必返 | 代币等级：0（UNKNOWN，未知）、1（NEUTRAL，中性）、2（OK，正常）、3（SUSPICIOUS，可疑）、4（UNSAFE，不安全） | — |
issuerAddr | string | 可选 | 发行方地址（TRX 无此字段） | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
timestamp | integer | 必返 | 时间戳 | 毫秒 |
tvl | string | 必返 | 当日总锁仓量 | USD |
tokens | array | 必返 | 各代币流动性详情 | — |
tokens[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenId | string | 必返 | 代币合约地址 | — |
liquidity | string | 必返 | 该代币流动性 | USD |
liquidityPercent | string | 必返 | 流动性占比 | 百分比字符串 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 缺少
pool参数：返回{"message":"pool is required"}。 - 空结果不等于错误：无数据时返回空数组，属于正常响应。
最后更新于: