Liquidity headline

GET

/lp/overview

const url = 'https://api.getchord.xyz/v1/lp/overview?chain=5042';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.getchord.xyz/v1/lp/overview?chain=5042'

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.

Parameters

Query Parameters

chain

required

integer

Allowed values: 5042 4663 143

Chain id: 5042 Arc · 4663 Robinhood Chain · 143 Monad.

Responses

200

application/json

object

chain

integer

pools24h

integer

tvlUsd

number

vol24hUsd

number

fees24hUsd

number

feesPoolsCounted

integer

lpAdd24hUsd

number

lpRemove24hUsd

number

providers24h

integer

best

object

pool

A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.

string

/^0x([a-fA-F0-9]{40}|[a-fA-F0-9]{64})$/

pair

string

token0

A token as it appears inside a pool row.

object

address

EVM address, hex, case-insensitive.

string

/^0x[a-fA-F0-9]{40}$/

symbol

Symbol from the contract, or null while unresolved.

string | null

decimals

ERC-20 decimals.

integer | null

logo

Logo URL, or null.

string | null

impostor

True when the symbol copies the chain’s anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.

boolean

token1

A token as it appears inside a pool row.

object

address

EVM address, hex, case-insensitive.

string

/^0x[a-fA-F0-9]{40}$/

symbol

Symbol from the contract, or null while unresolved.

string | null

decimals

ERC-20 decimals.

integer | null

logo

Logo URL, or null.

string | null

impostor

True when the symbol copies the chain’s anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.

boolean

dex

string

feeTvlPct

number

aprPct

number | null

tvlUsd

number | null

hot

Array<object>

object

pool

A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.

string

/^0x([a-fA-F0-9]{40}|[a-fA-F0-9]{64})$/

pair

string

token0

A token as it appears inside a pool row.

object

address

EVM address, hex, case-insensitive.

string

/^0x[a-fA-F0-9]{40}$/

symbol

Symbol from the contract, or null while unresolved.

string | null

decimals

ERC-20 decimals.

integer | null

logo

Logo URL, or null.

string | null

impostor

True when the symbol copies the chain’s anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.

boolean

token1

A token as it appears inside a pool row.

object

address

EVM address, hex, case-insensitive.

string

/^0x[a-fA-F0-9]{40}$/

symbol

Symbol from the contract, or null while unresolved.

string | null

decimals

ERC-20 decimals.

integer | null

logo

Logo URL, or null.

string | null

impostor

True when the symbol copies the chain’s anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.

boolean

dex

string

feeBps

number | null

fees24hUsd

number

feeTvlPct

number | null

tvlUsd

number | null

vol24hUsd

number

wallets24h

integer

inflow

Array<object>

object

pool

A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.

string

/^0x([a-fA-F0-9]{40}|[a-fA-F0-9]{64})$/

pair

string

token0

A token as it appears inside a pool row.

object

address

EVM address, hex, case-insensitive.

string

/^0x[a-fA-F0-9]{40}$/

symbol

Symbol from the contract, or null while unresolved.

string | null

decimals

ERC-20 decimals.

integer | null

logo

Logo URL, or null.

string | null

impostor

True when the symbol copies the chain’s anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.

boolean

token1

A token as it appears inside a pool row.

object

address

EVM address, hex, case-insensitive.

string

/^0x[a-fA-F0-9]{40}$/

symbol

Symbol from the contract, or null while unresolved.

string | null

decimals

ERC-20 decimals.

integer | null

logo

Logo URL, or null.

string | null

impostor

True when the symbol copies the chain’s anchor (a token called USDC that is not the USDC predeploy). Flagged, never hidden.

boolean

dex

string

netUsd

number

tvlUsd

number | null

updatedAt

Unix time, milliseconds — when the server built this answer.

integer

Example

{
  "chain": 5042,
  "pools24h": 416,
  "tvlUsd": 59062379.766785584,
  "vol24hUsd": 32606366.761442985,
  "fees24hUsd": 108337.05880814306,
  "feesPoolsCounted": 31,
  "lpAdd24hUsd": 18682513.45246684,
  "lpRemove24hUsd": 26568879.80331895,
  "providers24h": 1750,
  "best": {
    "pool": "0xf53f02d9041d00bbd92235b4c902b9f350c554a8ed2dc64fa0a4585aac413f09",
    "pair": "USDC / MURMUR",
    "token0": {
      "address": "0x3600000000000000000000000000000000000000",
      "symbol": "USDC",
      "decimals": 6,
      "logo": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602",
      "impostor": false
    },
    "token1": {
      "address": "0x8faae5592b9acc27a79fca745c6b872adf514a5d",
      "symbol": "MURMUR",
      "decimals": 18,
      "logo": "https://cdn.dexscreener.com/cms/images/QUq-IqT1GLQNkxMx?width=800&height=800&quality=95&format=auto",
      "impostor": false
    },
    "dex": "uniswap_v4",
    "feeTvlPct": 14.40921999562047,
    "aprPct": 5259.365298401472,
    "tvlUsd": 12650.66
  },
  "hot": [
    {
      "pool": "0x6a3bacaa6493734c1ac221ebf42cf530a96c1e02",
      "pair": "USDC / ARGUS",
      "token0": {
        "address": "0x3600000000000000000000000000000000000000",
        "symbol": "USDC",
        "decimals": 6,
        "logo": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602",
        "impostor": false
      },
      "token1": {
        "address": "0xece5ca8bf9220718e5727754026757512212cb3c",
        "symbol": "ARGUS",
        "decimals": 18,
        "logo": "https://cdn.dexscreener.com/cms/images/0lkViejHOEfB3StE?width=800&height=800&quality=95&format=auto",
        "impostor": false
      },
      "dex": "uniswap_v3",
      "feeBps": 100,
      "fees24hUsd": 21874.53260752,
      "feeTvlPct": 2.0870143590342853,
      "tvlUsd": 1048125.64,
      "vol24hUsd": 2187453.260752,
      "wallets24h": 598
    },
    {
      "pool": "0xb3f441e8871840ecfcb284e5cbb5b9c21a50e961e1c50109bdced25e429f00cc",
      "pair": "USDC / ARGUS",
      "token0": {
        "address": "0x3600000000000000000000000000000000000000",
        "symbol": "USDC",
        "decimals": 6,
        "logo": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602",
        "impostor": false
      },
      "token1": {
        "address": "0xece5ca8bf9220718e5727754026757512212cb3c",
        "symbol": "ARGUS",
        "decimals": 18,
        "logo": "https://cdn.dexscreener.com/cms/images/0lkViejHOEfB3StE?width=800&height=800&quality=95&format=auto",
        "impostor": false
      },
      "dex": "uniswap_v4",
      "feeBps": 98.5,
      "fees24hUsd": 14338.80123860194,
      "feeTvlPct": 4.759044987124094,
      "tvlUsd": 301295.77,
      "vol24hUsd": 1455715.861786999,
      "wallets24h": 313
    }
  ],
  "inflow": [
    {
      "pool": "0xd945caee4635bcd7fb8a9fa74dc1d0c4c1472782",
      "pair": "cirBTC / USDC",
      "token0": {
        "address": "0x171a4217b86a807a64eb94757db6849fb4bdbaa0",
        "symbol": "cirBTC",
        "decimals": 8,
        "logo": "https://coin-images.coingecko.com/coins/images/102172745/large/cirbtc.jpg?1775204071",
        "impostor": false
      },
      "token1": {
        "address": "0x3600000000000000000000000000000000000000",
        "symbol": "USDC",
        "decimals": 6,
        "logo": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602",
        "impostor": false
      },
      "dex": "slipstream_fork",
      "netUsd": 44469.43327364928,
      "tvlUsd": 570213.05
    },
    {
      "pool": "0xa2ed014384e061ec2aaccea186d41798dcf4da29264c44a676d3006fdc252ae0",
      "pair": "USDC / ARCOON",
      "token0": {
        "address": "0x3600000000000000000000000000000000000000",
        "symbol": "USDC",
        "decimals": 6,
        "logo": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602",
        "impostor": false
      },
      "token1": {
        "address": "0x4621a0baa0b5d97aae77704cf2a84dabe78a4fed",
        "symbol": "ARCOON",
        "decimals": 18,
        "logo": "https://ipfs.filebase.io/ipfs/bafybeiecv2b5gkrr5q4cesftgirntp4roqixhcily6ynfjitgdcunxm3x4",
        "impostor": false
      },
      "dex": "uniswap_v4",
      "netUsd": 24000.000013,
      "tvlUsd": 142471.24
    }
  ],
  "updatedAt": 1789891860138
}

400

Invalid parameters — error names the check that failed (INVALID_PARAMS, BAD_ADDRESS, BAD_LIMIT, BAD_HOURS, …).

application/json

Every non-2xx body.

object

error

required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string

message

For humans.

string

statusCode

HTTP status, when included.

integer

Example

{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}