## GET /openapi/v1/dex/tokens/pools

The decentralized-exchange pools that trade one DEX token.

### Query parameters

| Parameter | Type | Default | Notes |
|:--|:--|:--|:--|
| `chain_slug`, `address` | string | required | See [naming a token](#dex-tokens-what-the-endpoints-share) |

### Response

```json
{
  "code": 0,
  "message": "success",
  "message_key": "SUCCESS",
  "result": {
    "available": true,
    "data_time": "2026-10-21T07:55:00Z",
    "stale": false,
    "items": [
      {
        "pool_address": "0x6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
        "exchange_name": "Uniswap V3",
        "exchange_logo": "https://s2.coinmarketcap.com/static/img/exchanges/64x64/1348.png",
        "base_symbol": "XDP",
        "quote_symbol": "WETH",
        "liquidity": "1520000.25",
        "volume_24h": "8800000",
        "top_pool": true
      }
    ]
  }
}
```

Not paged, largest liquidity first, as the source orders them. Refreshed like the holders, and
expires the same way.

| Field | Type | Notes |
|:--|:--|:--|
| `available`, `data_time` | | As on `/dex/tokens/trades` |
| `stale` | boolean | Last refreshed more than an hour ago |
| `items[].pool_address` | string | |
| `items[].exchange_name` | string or `null` | The decentralized exchange |
| `items[].exchange_logo` | string | Its logo, or `""` when there is none |
| `items[].base_symbol`, `items[].quote_symbol` | string or `null` | |
| `items[].liquidity`, `items[].volume_24h` | string or `null` | USD |
| `items[].top_pool` | boolean | The source marks it a main pool; more than one can be |

### Examples

```bash
curl -H "X-Api-Key: <your-api-key>" \
  "https://open-api.coinworldcap.com/openapi/v1/dex/tokens/pools?chain_slug=base&address=0x07b3d902783c3c12b077508c3b5c00113d1291d0"
```

The errors are those of `/dex/tokens/holders`.