---
title: "A token's pools by health"
method: GET
path: "/lp/token/{address}/pools"
tags: ["Liquidity"]
---

# A token's pools by health

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

## Request

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

The token's pools ranked by the 0–100 health score with the reasons behind it, and launch facts on Arc (launcher, its share of the liquidity, when it last pulled).

## Path parameters

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

## Query parameters

- `chain` 5042 | 4663 | 143, required

## Response `200`

- object
  - `chain` integer
  - `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` string
    - `feeBps` number, nullable
    - `tvlUsd` number, nullable
    - `vol24h` number
    - `aprPct` number, nullable
    - `score` integer
    - `reasons` string[]
    - `launch` object, nullable: Launch facts (see /lp/pools/{pool}).
  - `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`, …).

---

[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)