DEX 币对交易记录
查询代币的 DEX 买卖成交记录。
GET/api/v1/markets/dex/trades
可查询数据
- 返回数据
- 代币的 DEX 买卖成交记录
- 市场覆盖
- Crypto
- 查询粒度
- 每次查询一个资产或链上代币部署；每条记录对应一笔 DEX 成交
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
资产定位
至少填写 query、ticker、symbol、asset_id 中一项，或同时填写 chain 和 token_address。
querystringquery示例BATON条件必须代币名称、代码或合约地址。
tickerstringquery示例BATON条件必须代币代码，query 的别名。
symbolstringquery示例BATON条件必须代币代码，query 的别名。
asset_idstringquery示例asset_baton条件必须GateData 标准资产 ID。
chainstringquery示例solana条件必须链标识；直接地址查询时必填，多链资产用于指定部署。
token_addressstringquery示例6Hebn672FvMSq61mo4HYq86QgLHgBUm6y8A9bXGppump条件必须代币合约地址，直接查询时与 chain 同时填写。
交易筛选
volume_gtnumberquery示例50000可选成交美元金额下限，仅返回大于该值的记录。
order_directionstringquery示例desc可选按成交时间排序：desc 或 asc。
时间范围
start_timeintegerquery示例1785513600可选开始时间，Unix 秒级时间戳，须早于结束时间。
end_timeintegerquery示例1787673600可选结束时间，Unix 秒级时间戳，建议与开始时间同时填写。
分页
page_indexintegerquery示例1可选页码，从 1 开始。
page_sizeintegerquery示例50可选每页返回数量。
响应
codeinteger示例0业务状态码，0 表示成功。
reasonstring原因说明。
messagestring示例success响应消息。
data[]object[]
记录列表。
pairstring示例<pair_address>币对或流动性池地址。
trade_timestring示例2026-08-26T02:11:33Z成交时间（ISO 8601）。
trade_timestampinteger示例1787710293成交时间（Unix 秒）。
chainstring示例solana链标识。
target_tokenstring示例<token_address>查询的代币地址。
amountnumber示例115038.351982代币数量。
makerstring示例<maker_address>操作钱包地址。
sidestring示例buybuy / sell
price_usdnumber示例0.0002492275930545849成交时美元价格。
volume_usdnumber示例28.67073157344成交美元金额。
block_numberinteger示例441765427区块高度。
tx_hashstring示例<transaction_hash>交易哈希。
tx_explorerstring示例https://solscan.io/tx/<transaction_hash>区块浏览器交易链接。
错误与降级
200
assets_resolve 名称多命中；从 data[] 候选确认。
200
对象已解析但无可用数据；empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效，或行情 listing 多命中；歧义响应含 required_params + candidates。
401
缺少 API Key，或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在；数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限；body 返回 retry_after，响应头同步返回 Retry-After。