---
title: "Liquidity adds and removes"
method: GET
path: "/chains/{chain}/token/{address}/liquidity"
tags: ["Avalanche, Base, BNB Chain"]
---

# Liquidity adds and removes

`GET /chains/{chain}/token/{address}/liquidity`

## Request

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

Liquidity added to and removed from the token's busiest V2 / V3-style pools of the day (up to 8), newest first, read live from the chain's Mint and Burn logs: no LP indexer runs for these chains. A V4 pool's log carries no amounts, so V4 pools are not read, nor pools paired with no reference asset of the chain; `poolsLeftOut` counts the day's pools not read (past the 8 busiest, V4, or with no reference asset). The reads stop at 300 events or one day: on a token whose pools churn (just-in-time liquidity bots on majors) the list is the newest events, `since` says how far back it reaches and `summary` is null; `summary` holds the day's figures only when the reads covered the whole day. `wallet` is the transaction's sender (the pool's own owner field is the position manager). Cached 60 seconds per token.

Chain-keyed data for Avalanche C-Chain, Base and BNB Chain, served from Chord's rollup tables for the chain (every swap summed by hour, token and venue). Only the trade tape, the prints ticker and the wallet read raw rows, scoped to one token or one wallet and bounded.

- **Access.** No key needed while the chain is public (all three are today). A chain whose tape is off, or that is not public yet, answers `400 UNSUPPORTED_CHAIN` ("chain N is not served yet") unless the request carries an `X-API-Key`; those answers are sent `Cache-Control: private`.
- **Ingest floor.** Every count, volume and print covers trades at or above the chain's floor, returned as `ingestFloor`. BNB Chain runs at $100 today; Avalanche and Base at 0.
- **Readiness.** `503 NOT_READY` until the chain's rollup has run on this deployment; `503 CHAIN_DATA_UNAVAILABLE` when the store cannot be read. Never treat either as "no trades".

## Path parameters

- `chain` 'avalanche' | 'base' | 'bnb' | 'arbitrum' | 'ethereum' | '43114' | '8453' | '56' | '42161' | '1', required
- `address` string, required: EVM address, hex, case-insensitive.

## Response `200`

- object
  - `chain` integer
  - `token` string: EVM address, hex, case-insensitive.
  - `events` object[]
    - `tx` string: Transaction hash.
    - `logIndex` integer
    - `pool` string: EVM address, hex, case-insensitive.
    - `dex` string
    - `kind` 'add' | 'remove'
    - `wallet` string, nullable: EVM address, hex, case-insensitive.
    - `token` string: EVM address, hex, case-insensitive.
    - `tokenAmt` number: Whole tokens.
    - `anchor` string: EVM address, hex, case-insensitive.
    - `anchorAmt` number: Whole units of the other side.
    - `usd` number: 0 when not priced.
    - `priced` boolean
    - `tickLower` integer, nullable
    - `tickUpper` integer, nullable
    - `block` integer
    - `ts` integer: Unix time, seconds, UTC.
  - `summary` object, nullable
    - `hours` integer
    - `adds` integer
    - `addUsd` number
    - `removes` integer
    - `removeUsd` number
    - `netUsd` number
    - `tokenOnlyAdds` integer: One-sided adds (no reference asset).
    - `tokenOnlyRemoves` integer
    - `providers` integer
  - `since` integer, nullable: Unix time, seconds, UTC.
  - `poolsRead` integer
  - `poolsLeftOut` integer
  - `updatedAt` integer: Unix time, milliseconds — when the server built this answer.

## Other responses

- `400`: `UNSUPPORTED_CHAIN` (unknown chain, a chain with its own routes, or a chain not served to this caller yet), or `BAD_ADDRESS`.
- `429`: Over the per-minute limit (`RATE_LIMIT_EXCEEDED`). Read `X-RateLimit-Reset` and back off.
- `503`: `NOT_READY` (the chain's rollup has not run on this deployment yet) or `CHAIN_DATA_UNAVAILABLE` (the store could not be read). 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)