GateData.AI

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
Query granularity
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

Asset identification

Provide query, ticker, symbol or asset_id, or both chain and token_address.

querystringqueryExampleBATONconditional

Token name, symbol or contract address.

tickerstringqueryExampleBATONconditional

Token ticker; alias of query.

symbolstringqueryExampleBATONconditional

Token symbol; alias of query.

asset_idstringqueryExampleasset_batonconditional

GateData asset ID.

chainstringqueryExamplesolanaconditional

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

token_addressstringqueryExample6Hebn672FvMSq61mo4HYq86QgLHgBUm6y8A9bXGppumpconditional

Token contract address; provide together with chain for direct lookup.

Transaction filters
volume_gtnumberqueryExample5000optional

Return records with USD value strictly greater than this threshold.

Pagination
page_indexintegerqueryExample1optional

Page number, starting at 1.

page_sizeintegerqueryExample15optional

Records per page.

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.