DEX 币对交易记录

查询代币的 DEX 买卖成交记录。

GET/api/v1/markets/dex/trades
数据域
行情与流动性
解析层级
加密资产
MCP 工具
market_data_query (task=dex_trades)

可查询数据

返回数据
代币的 DEX 买卖成交记录
市场覆盖
Crypto
每次返回什么
每次查询一个资产或链上代币部署;每条记录对应一笔 DEX 成交

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

按资产查询

使用资产标识或query定位,或在下一组同时填写chain与token_address。兼容别名不必一起填写

asset_idstringquery示例asset_baton条件必须

GateData 标准资产 ID

querystringquery示例BATON条件必须

代币名称、代码或合约地址

兼容定位字段
tickerstringquery示例BATON条件必须

代币代码,query 的别名

symbolstringquery示例BATON条件必须

代币代码,query 的别名

按链与合约地址查询

chain与token_address两项同时填写,定位指定链上的代币部署

chainstringquery示例solana条件必须

链标识;直接地址查询时必填,多链资产用于指定部署

token_addressstringquery示例6Hebn672FvMSq61mo4HYq86QgLHgBUm6y8A9bXGppump条件必须

代币合约地址,直接查询时与 chain 同时填写

DEX成交筛选

仅适用于DEX成交;金额门槛单位为USD

volume_gtnumberquery示例50000可选

成交美元金额下限,仅返回大于该值的记录

通用筛选与分页
page_sizeintegerquery示例50可选

每页返回数量

交易筛选
order_directionstringquery示例desc可选

按成交时间排序:desc 或 asc

时间范围
start_timeintegerquery示例1785513600可选

开始时间,Unix 秒级时间戳,须早于结束时间

end_timeintegerquery示例1787673600可选

结束时间,Unix 秒级时间戳,建议与开始时间同时填写

分页
page_indexintegerquery示例1可选

页码,从 1 开始

响应

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示例buy

buy / 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。