Skip to content
ChordChordChord Docs

Liquidity events

GET
/lp/events
curl --request GET \
  --url 'https://api.getchord.xyz/v1/lp/events?chain=5042&kind=add&limit=40&offset=0'

Adds, removes and fee collects on one token, wallet or pool, newest first, each valued in dollars where the pool has an anchor side. One of token, wallet or pool is required.

Parameters

Section titled “ Parameters ”

Query Parameters

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

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

token

EVM address, hex, case-insensitive.

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

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/
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})$/
kind
string
Allowed values: add remove collect
minUsd
number
limit
integer
default: 40 >= 1 <= 200
offset
integer
0 <= 10000

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json
object
chain
integer
events
Array<object>
object
tx

Transaction hash.

string
/^0x[a-fA-F0-9]{64}$/
logIndex
integer
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
Allowed values: add remove collect
wallet

EVM address, hex, case-insensitive.

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

EVM address, hex, case-insensitive.

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

EVM address, hex, case-insensitive.

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

Dollars that entered or left the pool.

number
priced

False when the event could not be valued (no anchor side).

boolean
tickLower
integer | null
tickUpper
integer | null
block
integer
ts

Unix time, seconds, UTC.

integer
manager

EVM address, hex, case-insensitive.

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

Position NFT id, for managed positions.

string | null
limit
integer
offset
integer
updatedAt

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

integer
Example
{
  "chain": 5042,
  "events": [
    {
      "tx": "0x74acfa695f6ea11770a2356a49b750c9c5e0685a8ee106ebfae67ccd049d4ba6",
      "logIndex": 20,
      "pool": "0xf53f02d9041d00bbd92235b4c902b9f350c554a8ed2dc64fa0a4585aac413f09",
      "dex": "uniswap_v4",
      "kind": "remove",
      "wallet": "0xc85d3ed2dfa128888e658e3a947f24bfa96db654",
      "token": "0x8faae5592b9acc27a79fca745c6b872adf514a5d",
      "tokenAmt": 0,
      "anchor": "0x3600000000000000000000000000000000000000",
      "anchorAmt": 90.769723,
      "usd": 90.769723,
      "priced": true,
      "tickLower": 352440,
      "tickUpper": 354519,
      "block": 21802531,
      "ts": 1789888952
    },
    {
      "tx": "0x74acfa695f6ea11770a2356a49b750c9c5e0685a8ee106ebfae67ccd049d4ba6",
      "logIndex": 18,
      "pool": "0xf53f02d9041d00bbd92235b4c902b9f350c554a8ed2dc64fa0a4585aac413f09",
      "dex": "uniswap_v4",
      "kind": "remove",
      "wallet": "0xc85d3ed2dfa128888e658e3a947f24bfa96db654",
      "token": "0x8faae5592b9acc27a79fca745c6b872adf514a5d",
      "tokenAmt": 0,
      "anchor": "0x3600000000000000000000000000000000000000",
      "anchorAmt": 72.615778,
      "usd": 72.615778,
      "priced": true,
      "tickLower": 350361,
      "tickUpper": 352440,
      "block": 21802531,
      "ts": 1789888952
    }
  ],
  "limit": 2,
  "offset": 0,
  "updatedAt": 1789891870679
}

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