Token on-chain activities
Query CEX flows, DEX trades and liquidity events for token deployments.
Available data
- Returns
- Query CEX flows, DEX trades and liquidity events for token deployments.
- What each request returns
- Separate cex_flows, dex_trades and lp_events groups in data.
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_idstringqueryconditionalCanonical asset ID
querystringqueryconditionalAsset name or symbol; may scan multiple token deployments
tickerstringqueryconditionalAsset ticker clue
symbolstringqueryconditionalAsset symbol
Provide chain and token_address together to select one token deployment
chainstringqueryExamplesolanaconditionalChain slug; supply together with token_address
token_addressstringqueryExampleSo11111111111111111111111111111111111111112conditionalToken deployment address. Supply chain and token_address together
Choose cex, dex, lp, all, or a comma-separated combination. Only filters for selected types are sent
event_typesstringqueryExampledex,lpoptionalcex | dex | lp | all; comma-separated OR values are supported, for example dex,lp. · Default: all
Applies to cex activity. Amount thresholds are token quantities
venuestringqueryoptionalCEX code or venue_id; comma-separated OR. Use only when event_types includes cex
cex_flow_directionstringqueryoptionalDefaults to inflow,outflow,exchange_transfer; all can include internal transfers. · Default: inflow,outflow,exchange_transfer
cex_min_amountnumberqueryoptionalMinimum token quantity for CEX flows, not USD. cex_min_usd is not supported
Applies to DEX trades. Amount thresholds are in USD
dex_sidestringqueryoptionalbuy | sell | all; comma-separated OR. · Default: all
dex_min_usdnumberqueryoptionalMinimum DEX trade value in USD. · Default: 10000
Applies to liquidity events. Amount thresholds are in USD
lp_sidestringqueryoptionaladd | remove | unilateral_add | unilateral_remove | all; comma-separated OR. · Default: all
lp_min_usdnumberqueryoptionalMinimum liquidity-event value in USD. · Default: 10
page_size limits each result group; max_scan_pages limits pages scanned per source
wallet_addressstringqueryoptionalFilter by wallet address
pageintegerqueryoptionalPage number. · Default: 1
page_sizeintegerqueryExample2optionalMaximum rows per event group. · Default: 50 · ≤ 100
max_scan_pagesintegerqueryExample1optionalMaximum pages scanned per source. · Default: 5 · ≤ 20
Response
Business data; shape is specific to this endpoint
cex_flowsobject[]Exchange-related transfers
dex_tradesobject[]DEX trades
lp_eventsobject[]Liquidity additions and removals
amountstringToken quantity as a decimal string
token_value_usdstringTransfer value in USD
flow_directionstringInflow, outflow or exchange-transfer direction
from_addressstringSender address
to_addressstringRecipient address
from_venue_idstring | nullSending exchange, or null
to_venue_idstring | nullReceiving exchange, or null
tx_timestringTransaction time in ISO 8601 UTC
tx_hashstringTransaction hash
tx_linkstringExplorer URL
amountstringToken quantity as a decimal string
price_usdstringUnit token price in USD
volume_usdstringTrade value in USD
sidestringTrade or liquidity-event direction
trade_timestringTrade time in ISO 8601 UTC
makerstringTrading address
pairstringPool or trading-pair address
tx_hashstringTransaction hash
tx_linkstringExplorer URL
amount0stringQuantity of token0
amount1stringQuantity of token1
token0_addressstringToken0 contract address
token1_addressstringToken1 contract address
total_volume_usdstringTotal liquidity-event value in USD
sidestringTrade or liquidity-event direction
block_timestampintegerBlock timestamp in Unix seconds
valuation_statusstringValuation availability
threshold_bypassedbooleanWhether the value threshold was bypassed
tx_hashstringTransaction hash
tx_linkstringExplorer URL
data_statusDataStatusBusiness status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage
errornull | string | objectNull on success; otherwise an error string or object
empty_reasonstringReason for an empty or unavailable result; may be absent
missing_fieldsstring[]Fields not supplied by the source
coverage_fromstringFirst date actually returned, not the requested start
coverage_tostringLast date actually returned, not a guarantee of continuous coverage
coverage_notestringCoverage and methodology notes
request_idstringRequest trace identifier
operation_idstringOperation identifier
route_codestringResponse route identifier
observed_atstringResponse observation time; not the business snapshot date
Response metadata
updated_atstringMetadata update time; not the business data time
object_refsobject[]Matched object references
limitationsstring[]Coverage or source limitations
sourcesobjectPer-source cex/dex/lp status, scanned_pages and next_page
limitationsstring[]Coverage or source limitations
applied_filtersobjectFilters and deployments actually scanned
applied_thresholdsobjectApplied CEX token-quantity and DEX/LP USD thresholds
resolved_assetobjectResolved asset; asset_id can be null for a direct address query without implying no data