> ## Documentation Index
> Fetch the complete documentation index at: https://docs.krokoswap.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pools

> Query pool information and liquidity distribution

# 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

```json theme={null}
[
  {
    "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

```json theme={null}
{
  "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 |