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
What each request returns
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

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_idstringqueryExampleasset_batonconditional

GateData asset ID

querystringqueryExampleBATONconditional

Token name, symbol or contract address

Compatible aliases
tickerstringqueryExampleBATONconditional

Token ticker; alias of query

symbolstringqueryExampleBATONconditional

Token symbol; alias of query

By chain and contract

Provide chain and token_address together to select one token deployment

chainstringqueryExamplesolanaconditional

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

token_addressstringqueryExample6Hebn672FvMSq61mo4HYq86QgLHgBUm6y8A9bXGppumpconditional

Token contract address; provide together with chain for direct lookup

DEX trade filters

Applies to DEX trades. Amount thresholds are in USD

volume_gtnumberqueryExample50000optional

Return records with USD value strictly greater than this threshold

Filters and pagination
page_sizeintegerqueryExample50optional

Records per page

Transaction filters
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

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.