---
title: "Liquidity flow for a token"
method: GET
path: "/lp/token/{address}"
tags: ["Liquidity"]
---

# Liquidity flow for a token

`GET /lp/token/{address}`

## Request

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

Adds, removes and net dollars over the window, one-sided (token-only) events counted but not valued, just-in-time liquidity (same-transaction add and remove) called out so the totals read right, the top providers and the pools by net flow.

## Path parameters

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

## Query parameters

- `chain` 5042 | 4663 | 143, required
- `hours` integer

## Response `200`

- object
  - `chain` integer
  - `token` string: EVM address, hex, case-insensitive.
  - `hours` integer
  - `adds` integer
  - `addUsd` number
  - `removes` integer
  - `removeUsd` number
  - `netUsd` number
  - `tokenOnlyAdds` integer
  - `tokenOnlyRemoves` integer
  - `jitTxs` integer
  - `jitUsd` number
  - `providers` integer
  - `top` object[]
    - `wallet` string: EVM address, hex, case-insensitive.
    - `netUsd` number
    - `addedUsd` number
    - `removedUsd` number
    - `events` integer
    - `lastTs` integer: Unix time, seconds, UTC.
  - `pools` object[]
    - `pool` string: A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.
    - `dex` string
    - `netUsd` number
    - `events` 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`, …).

---

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