DEX pool liquidity events

Query DEX pool liquidity additions and removals for a token.

GET/api/v1/markets/dex/liquidity-events
Domain
Market & Liquidity
Level
Crypto asset
MCP tool
market_data_query (task=dex_liquidity_events)

Available data

Returns
DEX pool liquidity additions and removals for a token
Market coverage
Crypto
What each request returns
One asset or on-chain token deployment per query; each row is one liquidity event

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

By asset

Use an asset identifier or query, or provide both chain and token_address in the next group. Aliases are alternatives, not additional required fields

asset_idstringqueryExampleasset_batonconditional

GateData asset ID

querystringqueryExampleBATONconditional

Token name, symbol or contract address

Compatible aliases
tickerstringqueryExampleBATONconditional

Token ticker; alias of query

symbolstringqueryExampleBATONconditional

Token symbol; alias of query

By chain and contract

Provide chain and token_address together to select one token deployment

chainstringqueryExamplesolanaconditional

Chain; required for direct lookup and used to select a deployment

token_addressstringqueryExample6Hebn672FvMSq61mo4HYq86QgLHgBUm6y8A9bXGppumpconditional

Token contract address; provide together with chain for direct lookup

Liquidity-event filters

Applies to liquidity events. Amount thresholds are in USD

volume_gtnumberqueryExample5000optional

Return records with USD value strictly greater than this threshold

Filters and pagination
page_sizeintegerqueryExample15optional

Records per page

Pagination
page_indexintegerqueryExample1optional

Page number, starting at 1

Response

codeintegerExample0

Business status; 0 means success

reasonstring

Reason

messagestringExamplesuccess

Response message

data[]object[]

Records

chainstringExamplesolana

Chain

pairstringExample<pair_address>

Pair or pool address

target_tokenstringExample<token_address>

Queried token address

makerstringExample<maker_address>

Wallet initiating the action

sidestringExampleremove

add / remove / unilateral_add / unilateral_remove

token0_addressstringExample<token0_address>

Token0 address

amount0numberExample16280.786976

Token0 amount added or removed

token1_addressstringExampleSo11111111111111111111111111111111111111…

Token1 address

amount1numberExample0.014062683

Token1 amount added or removed

block_numberintegerExample441761116

Block height

txn_hashstringExample<transaction_hash>

Transaction hash

block_timestampintegerExample1787708722

Block time in Unix seconds

tags[]string[]

Address or event tags

dexstringExamplemeteora_dlmm

DEX protocol

total_volume_usdnumberExample5.513285266738132

Liquidity event value in USD

token_pricenumberExample0.0002548183029809168

Token price in USD at event time

token0_symbolstringExampleTOKEN

Token0 symbol

token1_symbolstringExampleWSOL

Token1 symbol

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.