# Find Pools

Returns all pools that contain a specific token pair. This endpoint is useful for discovering available liquidity sources, comparing rates across different DEXs, and analyzing market depth for specific token pairs.

**Endpoint:** `GET https://api.liqd.ag/pools`

**Authentication**: None required - publicly accessible

**Rate Limits**: No rate limits

### Required Parameters

| Name     | Type    | Description                 | Required |
| -------- | ------- | --------------------------- | -------- |
| `tokenA` | address | Address of the first token  | Yes      |
| `tokenB` | address | Address of the second token | Yes      |

### Optional Parameters

| Name           | Type   | Description                                            | Default |
| -------------- | ------ | ------------------------------------------------------ | ------- |
| `excludeDexes` | string | Comma-separated list of router indices to exclude      | none    |
| `includeDexes` | string | Comma-separated list of router indices to include only | none    |

**Parameter Details:**

* **tokenA & tokenB**: The order doesn't matter - the API will find pools containing both tokens regardless of which is specified first
* **excludeDexes**: Useful if you want to exclude specific protocols from your analysis. Refer to the router indices in the response to identify which numbers correspond to which DEXs
* **includeDexes**: Useful if you want to include only specific protocols in your analysis. Cannot be used together with excludeDexes - use one or the other

**Example Requests:**

```
# Basic pool discovery
GET https://api.liqd.ag/pools?tokenA=0x47bb061C0204Af921F43DC73C7D7768d2672DdEE&tokenB=0xF26A8ab118f4C46A2D3C0C5cF4bf446008efBf8c

# Exclude specific DEXs (router indices 1 and 3)
GET https://api.liqd.ag/pools?tokenA=0x47bb061C0204Af921F43DC73C7D7768d2672DdEE&tokenB=0xF26A8ab118f4C46A2D3C0C5cF4bf446008efBf8c&excludeDexes=1,3

# Include only specific DEXs (router indices 5 and 15)
GET https://api.liqd.ag/pools?tokenA=0x47bb061C0204Af921F43DC73C7D7768d2672DdEE&tokenB=0xF26A8ab118f4C46A2D3C0C5cF4bf446008efBf8c&includeDexes=5,15


```

**Example Response:**

```json
{
  "success": true,
  "data": [
    {
      "poolAddress": "0x...",
      "pairedToken": "0x...",
      "routerIndex": 1,
      "fee": 0,
      "stable": true,
      "protocol": "KittenSwap",
      "pair": "WETH/USDC",
      "price": "1845.32"
    },
    {
      "poolAddress": "0x...",
      "pairedToken": "0x...",
      "routerIndex": 3,
      "fee": 500,
      "stable": false,
      "protocol": "HyperSwapV3",
      "pair": "WETH/USDC",
      "price": "1842.75"
    }
  ]
}
```