A token's pools by health

GET

/lp/token/{address}/pools

const url = 'https://api.getchord.xyz/v1/lp/token/example/pools?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/token/example/pools?chain=5042'

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

Parameters

Path Parameters

address

required

EVM address, hex, case-insensitive.

string

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

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

token

EVM address, hex, case-insensitive.

string

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

pools

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})$/

dex

string

kind

string

feeBps

number | null

tvlUsd

number | null

vol24h

number

aprPct

number | null

score

integer

reasons

Array<string>

launch

Launch facts (see /lp/pools/{pool}).

object | null

updatedAt

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

integer

Example

{
  "chain": 5042,
  "token": "0x171a4217b86a807a64eb94757db6849fb4bdbaa0",
  "pools": [
    {
      "pool": "0xd945caee4635bcd7fb8a9fa74dc1d0c4c1472782",
      "dex": "slipstream_fork",
      "kind": "clmm",
      "feeBps": 6,
      "tvlUsd": 570213.05,
      "vol24h": 772749.320668,
      "aprPct": 29.678749237025,
      "score": 75,
      "reasons": [],
      "launch": null
    },
    {
      "pool": "0xc955cbfb9d03cde6f78901a81740264f895b9c00025beb9115cf2d7b86b3ee5a",
      "dex": "uniswap_v4",
      "kind": "v4",
      "feeBps": 30,
      "tvlUsd": 14896.68,
      "vol24h": 13956.785425999999,
      "aprPct": 102.59118166913699,
      "score": 47,
      "reasons": [
        "the launcher holds 100% of the liquidity added"
      ],
      "launch": {
        "launcher": "0x6049c9a0e26405c0985f9e3685c87d0ae917f82b",
        "launcherName": "Uniswap Liquidity Launcher",
        "creator": "0x8007221ab6bdb20496eb74d038cbc5d590d1bea9",
        "hooks": null,
        "launchedTs": 1789559316,
        "launcherLpAddedUsd": 69592.12438223744,
        "totalLpAddedUsd": 69592.12438223744,
        "launcherSharePct": 100,
        "launcherLastRemoveTs": 1789838701,
        "launcherRemovedUsd": 51498.944581131305
      }
    }
  ],
  "updatedAt": 1789891866065
}

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"
}