Skip to main content
GET
Liquidity events
Retrieve token activity within this route’s token, pool and wallet scope. Use events=all to combine swaps with liquidity additions/removals, or events=liquidity for liquidity only. Omit events for the existing trades-only response. Add enrich=identity to identify wallets on either event type. Liquidity rows use type: add_liquidity | remove_liquidity, a single pool, and exact string amounts in tokens[]; they do not contain swap prices, volume or PnL. See the liquidity guide for REST examples, pagination and live rooms.

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.

currency
enum<string>

Adds price (per token) to every swap, in this currency at the time of the trade. sol: trades against SOL use the swap's own SOL and token amounts; other trades divide the USD price by the SOL/USD rate at that second. eur: the USD price divided by the EUR/USD rate at the time of the trade. price is null when the trade has no USD price or no rate is available. Liquidity rows are unchanged. Invalid values return HTTP 400.

Available options:
usd,
eur,
sol
marketCap
boolean
default:false

Set to true to add marketCap to every swap: price (in currency, USD by default) times the supply of the token's main pool. Uses the current supply, so a token that burned or minted since the trade is valued at today's supply.

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
currency
enum<string>

Currency of price and marketCap. Present when currency or marketCap is set.

Available options:
usd,
eur,
sol