获取流动性池的流动性变化图表
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 | 必返 | 代币等级 | — |
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"}。 - 空结果不等于错误:无数据时返回空数组,属于正常响应。
最后更新于: