获取流动性池变化趋势信息
1. 概述与典型用途
返回桑基图(Sankey)风格的数据结构,展示两个时间点之间流动性池的资金流入和流出情况。startTimestamp 必须晚于 2022-11-21 08:00:00,endTimestamp 必须早于当前时间。
- 典型用途:流动性池资金流向可视化、桑基图绘制。
- 何时不要用:查询流动性池的 TVL 历史变化用「获取流动性池的流动性变化图表」。
2. 接口与鉴权
GET /api/stableCoin/pool/trend
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
pool | string | 是 | — | 流动性池合约地址 |
startTimestamp | integer | 否 | — | 开始时间戳,毫秒;必须晚于 2022-11-21 08:00:00 |
endTimestamp | integer | 否 | 当前时间 | 结束时间戳,毫秒 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
data | array | 必返 | 桑基图节点数组 | — |
links | array | 必返 | 桑基图连线数组 | — |
data[] 元素(节点)
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
name | string | 必返 | 节点名称(如 in、out、USDT 2023-02-06) | — |
value | string | 可选 | 节点值(起始时间节点存在) | USD |
links[] 元素(连线)
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
source | string | 必返 | 来源节点名称 | — |
target | string | 必返 | 目标节点名称 | — |
value | string | 必返 | 流动金额 | USD |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 缺少
pool参数:返回{"message":"pool is required"}。 - 空结果不等于错误:无数据时返回空数组,属于正常响应。
最后更新于: