# Every indexed pool for a token

`GET https://api.getchord.xyz/v1/arc/token/{address}/pools`

Source: https://getchord.xyz/docs/api-reference/operations/arctokenpools/

V2 pairs, V3 pools and V4 pool ids (with hooks) that hold the token, with the creation block. For LP-oriented ranking use `/lp/token/{address}/pools`.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `address` | path | yes | string |  |

## Response 200

Example (captured from the live API):

```json
{
  "chain": 5042,
  "token": "0x171a4217b86a807a64eb94757db6849fb4bdbaa0",
  "pools": [
    {
      "pool": "0x82916bee18fcef517b26c72d7cb5f13694e1db41",
      "dex": "uniswap_v3",
      "kind": "clmm",
      "token0": "0x171a4217b86a807a64eb94757db6849fb4bdbaa0",
      "token1": "0x3600000000000000000000000000000000000000",
      "fee": 100,
      "createdBlock": 21076890
    },
    {
      "pool": "0xecd988913031a292bcf0e4e07ccd5815c8969a48",
      "dex": "uniswap_v3",
      "kind": "clmm",
      "token0": "0x171a4217b86a807a64eb94757db6849fb4bdbaa0",
      "token1": "0x3600000000000000000000000000000000000000",
      "fee": 3000,
      "createdBlock": 21081300
    }
  ],
  "updatedAt": 1789891855402
}
```

- **400**: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
- **503**: The lane behind this endpoint is not ready or not enabled here (`NOT_READY`, `CHAIN_NOT_ENABLED`, `NOT_ENABLED`, `*_UNAVAILABLE`). Retry later; do not treat it as an empty answer.