Skip to main content

​
Pools API

Query information about V3 liquidity pools.

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

Find all V3 pools for a specific token pair (one per fee tier).

​
Parameters

ParameterTypeRequiredDescription
token0stringYesFirst token address
token1stringYesSecond token address

​
Response

[
  {
    "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

Get the tick-level liquidity distribution for a V3 pool. Used to render depth charts.

​
Parameters

ParameterTypeRequiredDescription
addressstring (path)YesV3 pool address

​
Response

{
  "poolAddress": "0x...",
  "tickLiquidity": [
    {
      "tick": -1000,
      "liquidityGross": "500000000000000000",
      "liquidityNet": "500000000000000000"
    },
    {
      "tick": -940,
      "liquidityGross": "300000000000000000",
      "liquidityNet": "-300000000000000000"
    }
  ],
  "stats": {
    "totalLiquidity": "800000000000000000",
    "totalPositions": 42
  }
}
FieldDescription
tickTick index where liquidity changes
liquidityGrossTotal liquidity referencing this tick
liquidityNetNet liquidity change when crossing this tick (positive = add, negative = remove)

​
Additional Pool Endpoints

EndpointDescription
GET /api/v1/pools/:address/priceCurrent pool price
GET /api/v1/pools/:address/tvlTotal value locked
GET /api/v1/pools/:address/volumeTrading volume
GET /api/v1/pools/:address/aprAnnual percentage rate
GET /api/v1/pools/:address/positionsActive positions
GET /api/v1/pools/:address/tick-liquidityRaw tick liquidity data