Skip to content
ChordChordChord Docs

Liquidity flow for a token

GET
/lp/token/{address}
curl --request GET \
  --url 'https://api.getchord.xyz/v1/lp/token/example?chain=5042&hours=24'

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.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
address
required

EVM address, hex, case-insensitive.

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

Query Parameters

Section titled “Query Parameters”
chain
required
integer
Allowed values: 5042 4663 143

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

hours
integer
default: 24 >= 1 <= 720

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json
object
chain
integer
token

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/
hours
integer
adds
integer
addUsd
number
removes
integer
removeUsd
number
netUsd
number
tokenOnlyAdds
integer
tokenOnlyRemoves
integer
jitTxs
integer
jitUsd
number
providers
integer
top
Array<object>
object
wallet

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/
netUsd
number
addedUsd
number
removedUsd
number
events
integer
lastTs

Unix time, seconds, UTC.

integer
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
netUsd
number
events
integer
updatedAt

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

integer
Example
{
  "chain": 5042,
  "token": "0x171a4217b86a807a64eb94757db6849fb4bdbaa0",
  "hours": 24,
  "adds": 200,
  "addUsd": 274228.1437317083,
  "removes": 176,
  "removeUsd": 2291418.4063887238,
  "netUsd": -2017190.2626570156,
  "tokenOnlyAdds": 5,
  "tokenOnlyRemoves": 30,
  "jitTxs": 18,
  "jitUsd": 39153.40135616365,
  "providers": 51,
  "top": [
    {
      "wallet": "0xa77401a1640e4f090fd5d08b7350b59d6a99b0fd",
      "netUsd": -2064877.6495731266,
      "addedUsd": 0,
      "removedUsd": 2063818.8216671266,
      "events": 2,
      "lastTs": 1789845091
    },
    {
      "wallet": "0x08d0d1d9d58675fea6e36670d85a9e8dad89f465",
      "netUsd": 21439.05777238525,
      "addedUsd": 21439.05777238525,
      "removedUsd": 0,
      "events": 1,
      "lastTs": 1789817213
    }
  ],
  "pools": [
    {
      "pool": "0x82916bee18fcef517b26c72d7cb5f13694e1db41",
      "dex": "uniswap_v3",
      "netUsd": -2065710.8817895816,
      "events": 88
    },
    {
      "pool": "0xd945caee4635bcd7fb8a9fa74dc1d0c4c1472782",
      "dex": "slipstream_fork",
      "netUsd": 44581.441725988414,
      "events": 282
    }
  ],
  "updatedAt": 1789891863259
}

400

Section titled “400”

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

Media typeapplication/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"
}