> ## 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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.