DEX pair trades

Query a token’s DEX buy and sell trades.

GET/api/v1/markets/dex/trades

Domain

Market & Liquidity

Level

Crypto asset

MCP tool

market_data_query (task=dex_trades)

Available data

Returns: A token’s DEX buy and sell trades
Market coverage: Crypto
Query granularity: One asset or on-chain token deployment per query; each row is one DEX trade

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_gtnumberqueryExample50000optional

Return records with USD value strictly greater than this threshold.

order_directionstringqueryExampledescoptional

Sort by trade time: desc or asc.

Time range

start_timeintegerqueryExample1785513600optional

Start time in Unix seconds; must precede end time.

end_timeintegerqueryExample1787673600optional

End time in Unix seconds; use with start time.

Pagination

page_indexintegerqueryExample1optional

Page number, starting at 1.

page_sizeintegerqueryExample50optional

Records per page.

Response

codeintegerExample0

Business status; 0 means success.

reasonstring

Reason.

messagestringExamplesuccess

Response message.

data[]object[]

Records.

pairstringExample<pair_address>

Pair or pool address.

trade_timestringExample2026-08-26T02:11:33Z

Trade time (ISO 8601).

trade_timestampintegerExample1787710293

Trade time in Unix seconds.

chainstringExamplesolana

Chain.

target_tokenstringExample<token_address>

Queried token address.

amountnumberExample115038.351982

Token amount.

makerstringExample<maker_address>

Wallet initiating the action.

sidestringExamplebuy

buy / sell

price_usdnumberExample0.0002492275930545849

Trade price in USD.

volume_usdnumberExample28.67073157344

Trade value in USD.

block_numberintegerExample441765427

Block height.

tx_hashstringExample<transaction_hash>

Transaction hash.

tx_explorerstringExamplehttps://solscan.io/tx/<transaction_hash>

Explorer transaction URL.

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.