---
title: "Every indexed pool for a token"
method: GET
path: "/arc/token/{address}/pools"
tags: ["Arc data"]
---

# Every indexed pool for a token

`GET /arc/token/{address}/pools`

## Request

- Base URL: `https://api.getchord.xyz/v1`
- URL: `https://api.getchord.xyz/v1/arc/token/{address}/pools`
- Auth: none declared

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`.

## Path parameters

- `address` string, required: EVM address, hex, case-insensitive.

## Response `200`

- object
  - `chain` 5042
  - `token` string: EVM address, hex, case-insensitive.
  - `pools` object[]
    - `pool` string: A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.
    - `dex` string
    - `kind` 'clmm' | 'v2' | 'v4'
    - `token0` string: EVM address, hex, case-insensitive.
    - `token1` string: EVM address, hex, case-insensitive.
    - `fee` integer, nullable: Fee in pips (100 = 0.01%).
    - `hooks` string: EVM address, hex, case-insensitive.
    - `createdBlock` integer
  - `updatedAt` integer: Unix time, milliseconds — when the server built this answer.

## Other responses

- `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.

---

[API](https://skmtc.dev/getchord/apis/chord-api.md) · [All operations](https://skmtc.dev/getchord/apis/chord-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getchord/apis/chord-api/revisions/d3bc4640fea0?raw)