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

Parameter	Type	Required	Description
`token0`	`string`	Yes	First token address
`token1`	`string`	Yes	Second 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

Parameter	Type	Required	Description
`address`	`string` (path)	Yes	V3 pool address

Response

{
  "poolAddress": "0x...",
  "tickLiquidity": [
    {
      "tick": -1000,
      "liquidityGross": "500000000000000000",
      "liquidityNet": "500000000000000000"
    },
    {
      "tick": -940,
      "liquidityGross": "300000000000000000",
      "liquidityNet": "-300000000000000000"
    }
  ],
  "stats": {
    "totalLiquidity": "800000000000000000",
    "totalPositions": 42
  }
}

Field	Description
`tick`	Tick index where liquidity changes
`liquidityGross`	Total liquidity referencing this tick
`liquidityNet`	Net liquidity change when crossing this tick (positive = add, negative = remove)

Additional Pool Endpoints

Endpoint	Description
`GET /api/v1/pools/:address/price`	Current pool price
`GET /api/v1/pools/:address/tvl`	Total value locked
`GET /api/v1/pools/:address/volume`	Trading volume
`GET /api/v1/pools/:address/apr`	Annual percentage rate
`GET /api/v1/pools/:address/positions`	Active positions
`GET /api/v1/pools/:address/tick-liquidity`	Raw tick liquidity data