---
title: "Liquidity headline"
method: GET
path: "/lp/overview"
tags: ["Liquidity"]
---

# Liquidity headline

`GET /lp/overview`

## Request

- Base URL: `https://api.getchord.xyz/v1`
- URL: `https://api.getchord.xyz/v1/lp/overview`
- Auth: none declared

The pools page pulse: fees paid to LPs in 24 hours (top 100 pools by fees), the best real yield (≥ 25 traders, not suspect), dollars added and removed, volume, TVL and providers over pools with ≥ $10k TVL, the six hottest pools by fees and the three biggest net inflows. Memoised 30 s.

## Query parameters

- `chain` 5042 | 4663 | 143, required

## Response `200`

- object
  - `chain` integer
  - `pools24h` integer
  - `tvlUsd` number
  - `vol24hUsd` number
  - `fees24hUsd` number
  - `feesPoolsCounted` integer
  - `lpAdd24hUsd` number
  - `lpRemove24hUsd` number
  - `providers24h` integer
  - `best` object, nullable
    - `pool` string: A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.
    - `pair` string
    - `token0` TokenLite: A token as it appears inside a pool row.
      - `address` string: EVM address, hex, case-insensitive.
      - `symbol` string, nullable: Symbol from the contract, or null while unresolved.
      - `decimals` integer, nullable: ERC-20 decimals.
      - `logo` string, nullable: Logo URL, or null.
      - `impostor` boolean: True when the symbol copies the chain's anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.
    - `token1` TokenLite: A token as it appears inside a pool row.
      - `address` string: EVM address, hex, case-insensitive.
      - `symbol` string, nullable: Symbol from the contract, or null while unresolved.
      - `decimals` integer, nullable: ERC-20 decimals.
      - `logo` string, nullable: Logo URL, or null.
      - `impostor` boolean: True when the symbol copies the chain's anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.
    - `dex` string
    - `feeTvlPct` number
    - `aprPct` number, nullable
    - `tvlUsd` number, nullable
  - `hot` object[]
    - `pool` string: A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.
    - `pair` string
    - `token0` TokenLite: A token as it appears inside a pool row.
      - `address` string: EVM address, hex, case-insensitive.
      - `symbol` string, nullable: Symbol from the contract, or null while unresolved.
      - `decimals` integer, nullable: ERC-20 decimals.
      - `logo` string, nullable: Logo URL, or null.
      - `impostor` boolean: True when the symbol copies the chain's anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.
    - `token1` TokenLite: A token as it appears inside a pool row.
      - `address` string: EVM address, hex, case-insensitive.
      - `symbol` string, nullable: Symbol from the contract, or null while unresolved.
      - `decimals` integer, nullable: ERC-20 decimals.
      - `logo` string, nullable: Logo URL, or null.
      - `impostor` boolean: True when the symbol copies the chain's anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.
    - `dex` string
    - `feeBps` number, nullable
    - `fees24hUsd` number
    - `feeTvlPct` number, nullable
    - `tvlUsd` number, nullable
    - `vol24hUsd` number
    - `wallets24h` integer
  - `inflow` object[]
    - `pool` string: A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.
    - `pair` string
    - `token0` TokenLite: A token as it appears inside a pool row.
      - `address` string: EVM address, hex, case-insensitive.
      - `symbol` string, nullable: Symbol from the contract, or null while unresolved.
      - `decimals` integer, nullable: ERC-20 decimals.
      - `logo` string, nullable: Logo URL, or null.
      - `impostor` boolean: True when the symbol copies the chain's anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.
    - `token1` TokenLite: A token as it appears inside a pool row.
      - `address` string: EVM address, hex, case-insensitive.
      - `symbol` string, nullable: Symbol from the contract, or null while unresolved.
      - `decimals` integer, nullable: ERC-20 decimals.
      - `logo` string, nullable: Logo URL, or null.
      - `impostor` boolean: True when the symbol copies the chain's anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.
    - `dex` string
    - `netUsd` number
    - `tvlUsd` number, nullable
  - `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)