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

# Pools

> List pools and fetch pool metadata.

## List pools

```
GET https://zap.dzap.io/v1/pools
```

Returns pools available across supported protocols, optionally filtered by chain or DEX.

### Query

<ParamField query="chainId" type="integer">Filter by chain.</ParamField>

<ParamField query="protocol" type="string">e.g. `uniswap-v3`, `pancake-v3`, `aerodrome`.</ParamField>

<ParamField query="tokens" type="string">Comma-separated token addresses; returns pools containing all listed tokens.</ParamField>

<ParamField query="limit" type="integer">Default 50, max 200.</ParamField>

### Response

<ResponseField name="data.pools" type="object[]">List of pools with `address`, `protocol`, `tokens`, `tvl`, `apr`, `feeTier`.</ResponseField>

## Pool details

```
POST https://zap.dzap.io/v1/pool/details
```

### Body

<ParamField body="chainId" type="integer" required />

<ParamField body="poolAddress" type="string" required />

### Response

<ResponseField name="data" type="object">Full pool detail: tokens, tick range, current tick, liquidity, recent trades.</ResponseField>

### Examples

<RequestExample>
  ```bash list theme={null}
  curl "https://zap.dzap.io/v1/pools?chainId=8453&protocol=uniswap-v3&limit=10"
  ```

  ```bash details theme={null}
  curl -X POST https://zap.dzap.io/v1/pool/details \
    -H "Content-Type: application/json" \
    -d '{ "chainId": 8453, "poolAddress": "0xd0b53D9277642d899DF5C87A3966A349A798F224" }'
  ```
</RequestExample>