跳转到主要内容

​
Pools API

查询 V3 流动性池子的信息。

​
GET /api/v1/pools/v3/find

查找特定代币对的所有 V3 池子（每个手续费等级一个）。

​
参数

参数类型必填描述
token0string是第一个代币地址
token1string是第二个代币地址

​
响应

[
  {
    "address": "0x...",
    "fee": 500,
    "liquidity": "1234567890000000000",
    "sqrtPriceX96": "79228162514264337593543950336",
    "tick": 0,
    "price": "1.0"
  },
  {
    "address": "0x...",
    "fee": 3000,
    "liquidity": "9876543210000000000",
    "sqrtPriceX96": "79228162514264337593543950336",
    "tick": 0,
    "price": "1.0"
  }
]

​
GET /api/v1/pools/:address/liquidity-distribution

获取 V3 池子的 tick 级别流动性分布数据。用于渲染深度图。

​
参数

参数类型必填描述
addressstring（路径参数）是V3 池子地址

​
响应

{
  "poolAddress": "0x...",
  "tickLiquidity": [
    {
      "tick": -1000,
      "liquidityGross": "500000000000000000",
      "liquidityNet": "500000000000000000"
    },
    {
      "tick": -940,
      "liquidityGross": "300000000000000000",
      "liquidityNet": "-300000000000000000"
    }
  ],
  "stats": {
    "totalLiquidity": "800000000000000000",
    "totalPositions": 42
  }
}
字段描述
tick流动性发生变化的 tick 索引
liquidityGross引用此 tick 的总流动性
liquidityNet穿越此 tick 时的净流动性变化（正值 = 增加，负值 = 减少）

​
其他池子端点

端点描述
GET /api/v1/pools/:address/price当前池子价格
GET /api/v1/pools/:address/tvl总锁仓价值
GET /api/v1/pools/:address/volume交易量
GET /api/v1/pools/:address/apr年化收益率
GET /api/v1/pools/:address/positions活跃仓位
GET /api/v1/pools/:address/tick-liquidity原始 tick 流动性数据