Skip to main content
GET
Liquidity events

SDK Example

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

tokenAddress
string
required
poolAddress
string
required
owner
string
required

Query Parameters

events
enum<string>
default:trades

Choose trades (default), all (swaps plus liquidity), or liquidity (add/remove actions only). All modes return a trades array. Invalid values return HTTP 400.

Available options:
trades,
all,
liquidity
enrich
string

Pass identity to attach wallet identity to every returned trade or liquidity event, using the same enrichment as token holders. Includes available KOL profiles, tags, trading platforms and profiles, developer/pool labels, curated labels, and SNS names. Unknown wallets return identity: null. Omit for unchanged responses and no identity lookups. all and * also enable identity; pool and developer are compatibility aliases.

cursor
string

Pass nextCursor back unchanged. Default trades use a timestamp; events=all and events=liquidity return an opaque string scoped to the token, pool, wallet, events and sortDirection. Keep these filters unchanged between pages.

limit
integer
default:250

Number of results, default 250, maximum 500. With events=all or events=liquidity the range is 1–500.

Required range: 1 <= x <= 500
sortDirection
enum<string>
default:DESC

Chronological order: DESC (newest first) or ASC (oldest first). Invalid values return HTTP 400.

Available options:
ASC,
DESC
showMeta
boolean

Set to true to add from/to token metadata to swaps. Liquidity rows retain their tokens array without swap metadata.

hideArb
boolean

Set to true to keep swap legs involving the requested token. Liquidity actions are retained.

Response

Successful response

trades
object[]
nextCursor

Timestamp for trades-only requests; opaque string for events=all/liquidity. Pass back unchanged with the same filters. Null at the end.

hasNextPage
boolean
sortDirection
enum<string>
Available options:
ASC,
DESC