Token on-chain activities

Query CEX flows, DEX trades and liquidity events for token deployments.

GET/api/v1/onchain/token-activities
Domain
Network & Protocol
Level
Separate cex_flows, dex_trades and lp_events groups in data.
MCP tool
REST-only

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

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_idstringqueryconditional

Canonical asset ID

querystringqueryconditional

Asset name or symbol; may scan multiple token deployments

Compatible aliases
tickerstringqueryconditional

Asset ticker clue

symbolstringqueryconditional

Asset symbol

By chain and contract

Provide chain and token_address together to select one token deployment

chainstringqueryExamplesolanaconditional

Chain slug; supply together with token_address

token_addressstringqueryExampleSo11111111111111111111111111111111111111112conditional

Token deployment address. Supply chain and token_address together

Activity types

Choose cex, dex, lp, all, or a comma-separated combination. Only filters for selected types are sent

event_typesstringqueryExampledex,lpoptional

cex | dex | lp | all; comma-separated OR values are supported, for example dex,lp. · Default: all

Exchange-flow filters

Applies to cex activity. Amount thresholds are token quantities

venuestringqueryoptional

CEX code or venue_id; comma-separated OR. Use only when event_types includes cex

cex_flow_directionstringqueryoptional

Defaults to inflow,outflow,exchange_transfer; all can include internal transfers. · Default: inflow,outflow,exchange_transfer

cex_min_amountnumberqueryoptional

Minimum token quantity for CEX flows, not USD. cex_min_usd is not supported

DEX trade filters

Applies to DEX trades. Amount thresholds are in USD

dex_sidestringqueryoptional

buy | sell | all; comma-separated OR. · Default: all

dex_min_usdnumberqueryoptional

Minimum DEX trade value in USD. · Default: 10000

Liquidity-event filters

Applies to liquidity events. Amount thresholds are in USD

lp_sidestringqueryoptional

add | remove | unilateral_add | unilateral_remove | all; comma-separated OR. · Default: all

lp_min_usdnumberqueryoptional

Minimum liquidity-event value in USD. · Default: 10

Filters and pagination

page_size limits each result group; max_scan_pages limits pages scanned per source

wallet_addressstringqueryoptional

Filter by wallet address

pageintegerqueryoptional

Page number. · Default: 1

page_sizeintegerqueryExample2optional

Maximum rows per event group. · Default: 50 · ≤ 100

max_scan_pagesintegerqueryExample1optional

Maximum pages scanned per source. · Default: 5 · ≤ 20

Response

dataobject

Business data; shape is specific to this endpoint

cex_flowsobject[]

Exchange-related transfers

dex_tradesobject[]

DEX trades

lp_eventsobject[]

Liquidity additions and removals

cex_flows[]array[object]
amountstring

Token quantity as a decimal string

token_value_usdstring

Transfer value in USD

flow_directionstring

Inflow, outflow or exchange-transfer direction

from_addressstring

Sender address

to_addressstring

Recipient address

from_venue_idstring | null

Sending exchange, or null

to_venue_idstring | null

Receiving exchange, or null

tx_timestring

Transaction time in ISO 8601 UTC

tx_hashstring

Transaction hash

tx_linkstring

Explorer URL

dex_trades[]array[object]
amountstring

Token quantity as a decimal string

price_usdstring

Unit token price in USD

volume_usdstring

Trade value in USD

sidestring

Trade or liquidity-event direction

trade_timestring

Trade time in ISO 8601 UTC

makerstring

Trading address

pairstring

Pool or trading-pair address

tx_hashstring

Transaction hash

tx_linkstring

Explorer URL

lp_events[]array[object]
amount0string

Quantity of token0

amount1string

Quantity of token1

token0_addressstring

Token0 contract address

token1_addressstring

Token1 contract address

total_volume_usdstring

Total liquidity-event value in USD

sidestring

Trade or liquidity-event direction

block_timestampinteger

Block timestamp in Unix seconds

valuation_statusstring

Valuation availability

threshold_bypassedboolean

Whether the value threshold was bypassed

tx_hashstring

Transaction hash

tx_linkstring

Explorer URL

data_statusDataStatus

Business status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage

errornull | string | object

Null on success; otherwise an error string or object

empty_reasonstring

Reason for an empty or unavailable result; may be absent

missing_fieldsstring[]

Fields not supplied by the source

coverage_fromstring

First date actually returned, not the requested start

coverage_tostring

Last date actually returned, not a guarantee of continuous coverage

coverage_notestring

Coverage and methodology notes

request_idstring

Request trace identifier

operation_idstring

Operation identifier

route_codestring

Response route identifier

observed_atstring

Response observation time; not the business snapshot date

metadataobject

Response metadata

updated_atstring

Metadata update time; not the business data time

object_refsobject[]

Matched object references

limitationsstring[]

Coverage or source limitations

sourcesobject

Per-source cex/dex/lp status, scanned_pages and next_page

limitationsstring[]

Coverage or source limitations

applied_filtersobject

Filters and deployments actually scanned

applied_thresholdsobject

Applied CEX token-quantity and DEX/LP USD thresholds

resolved_assetobject

Resolved asset; asset_id can be null for a direct address query without implying no data

Errors & fallback

200
Only part of the requested data is available. Inspect missing_fields, limitations and actual coverage.
200
A requested source is unavailable; inspect sources and limitations.
401
Check the API key.
403
Check data-domain permissions for the key.