DEX pool liquidity events
Query DEX pool liquidity additions and removals for a token.
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
Query Parameters
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_batonconditionalGateData asset ID
querystringqueryExampleBATONconditionalToken name, symbol or contract address
tickerstringqueryExampleBATONconditionalToken ticker; alias of query
symbolstringqueryExampleBATONconditionalToken symbol; alias of query
Provide chain and token_address together to select one token deployment
chainstringqueryExamplesolanaconditionalChain; required for direct lookup and used to select a deployment
token_addressstringqueryExample6Hebn672FvMSq61mo4HYq86QgLHgBUm6y8A9bXGppumpconditionalToken contract address; provide together with chain for direct lookup
Applies to liquidity events. Amount thresholds are in USD
volume_gtnumberqueryExample5000optionalReturn records with USD value strictly greater than this threshold
page_sizeintegerqueryExample15optionalRecords per page
page_indexintegerqueryExample1optionalPage number, starting at 1
Response
codeintegerExample0Business status; 0 means success
reasonstringReason
messagestringExamplesuccessResponse message
Records
chainstringExamplesolanaChain
pairstringExample<pair_address>Pair or pool address
target_tokenstringExample<token_address>Queried token address
makerstringExample<maker_address>Wallet initiating the action
sidestringExampleremoveadd / remove / unilateral_add / unilateral_remove
token0_addressstringExample<token0_address>Token0 address
amount0numberExample16280.786976Token0 amount added or removed
token1_addressstringExampleSo11111111111111111111111111111111111111…Token1 address
amount1numberExample0.014062683Token1 amount added or removed
block_numberintegerExample441761116Block height
txn_hashstringExample<transaction_hash>Transaction hash
block_timestampintegerExample1787708722Block time in Unix seconds
tags[]string[]Address or event tags
dexstringExamplemeteora_dlmmDEX protocol
total_volume_usdnumberExample5.513285266738132Liquidity event value in USD
token_pricenumberExample0.0002548183029809168Token price in USD at event time
token0_symbolstringExampleTOKENToken0 symbol
token1_symbolstringExampleWSOLToken1 symbol