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

# EVM Liquidity Pools

> List Uniswap V4 and PancakeSwap V4 liquidity pools for a token on EVM chains.

List the Uniswap V4 and PancakeSwap V4 liquidity pools that hold a given token. Both endpoints take the same parameters and return the same shape.

***

## Uniswap V4 Pools

Find Uniswap V4 pools for a token.

**Endpoint:** `/evm/uniswap-v4/liquidity-pools`

| Parameter | Type | Required | Description |
| - | - | - | - |
| `chain` | string | Yes | Chain identifier: `eth`, `base`, or `bsc` |
| `token` | string | Yes | Token contract address |
| `maxPools` | number | No | Maximum number of pools to return |
| `backingTokens` | string\[] | No | Restrict results to pools paired against these token addresses |

**Example:**

> [tab] Socket.IO
>
> ```typescript theme={null}
> socket.emit("/evm/uniswap-v4/liquidity-pools", {
>   chain: "eth",
>   token: "0x6982508145454Ce325dDbE47a25d4ec3d2311933", // PEPE
> });
> ```

> [tab] HTTP
>
> ```typescript theme={null}
> await fetch("https://api.chainworks.co/evm/uniswap-v4/liquidity-pools", {
>   method: "POST",
>   headers: {
>     "Content-Type": "application/json",
>     Authorization: CHAINWORKS_API_AUTH_TOKEN,
>   },
>   body: JSON.stringify({
>     chain: "eth",
>     token: "0x6982508145454Ce325dDbE47a25d4ec3d2311933", // PEPE
>   }),
> });
> ```

**Response:**

`result` is an array of pools, or `null` when none are found.

```json theme={null}
{
  "success": true,
  "result": [
    {
      "poolId": "0x9a8...c41",
      "tick": -198432,
      "tickSpacing": "60",
      "sqrtPriceX96": "1023456789012345678901234",
      "fee": 3000,
      "currency0": "0x0000000000000000000000000000000000000000",
      "currency1": "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
      "hooks": "0x0000000000000000000000000000000000000000",
      "blockNumber": "19500000"
    }
  ]
}
```

| Field | Type | Description |
| - | - | - |
| `poolId` | string | Pool identifier |
| `tick` | number | Current tick |
| `tickSpacing` | string | Tick spacing of the pool |
| `sqrtPriceX96` | string | Current price as a Q64.96 square root |
| `fee` | number | Pool fee tier |
| `currency0` | string | First currency address (the zero address denotes native currency) |
| `currency1` | string | Second currency address |
| `hooks` | string | Hooks contract address (the zero address denotes no hooks) |
| `blockNumber` | string | Block number the data was read at |
| `parameters` | string \| null | Encoded pool parameters. May be absent |
| `protocolFee` | number \| null | Protocol fee. May be absent |
| `positions` | object\[] | Liquidity positions for the pool. May be absent |

***

## PancakeSwap V4 Pools

Find PancakeSwap V4 pools for a token. Same parameters and response shape as Uniswap V4 Pools.

**Endpoint:** `/evm/pcs-v4/liquidity-pools`

**Example:**

> [tab] Socket.IO
>
> ```typescript theme={null}
> socket.emit("/evm/pcs-v4/liquidity-pools", {
>   chain: "bsc",
>   token: "0xTokenAddress",
> });
> ```

> [tab] HTTP
>
> ```typescript theme={null}
> await fetch("https://api.chainworks.co/evm/pcs-v4/liquidity-pools", {
>   method: "POST",
>   headers: {
>     "Content-Type": "application/json",
>     Authorization: CHAINWORKS_API_AUTH_TOKEN,
>   },
>   body: JSON.stringify({
>     chain: "bsc",
>     token: "0xTokenAddress",
>   }),
> });
> ```


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