DEX pool流动性增减记录

查询代币的 DEX pool 流动性增减记录。

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

可查询数据

返回数据
代币的 DEX pool 流动性增减记录
市场覆盖
Crypto
每次返回什么
每次查询一个资产或链上代币部署;每条记录对应一次流动性增减事件

认证

所有请求需携带 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 同时填写

流动性事件筛选

仅适用于流动性事件;金额门槛单位为USD

volume_gtnumberquery示例5000可选

流动性事件美元金额下限,仅返回大于该值的记录

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

每页返回数量

分页
page_indexintegerquery示例1可选

页码,从 1 开始

响应

codeinteger示例0

业务状态码,0 表示成功

reasonstring

原因说明

messagestring示例success

响应消息

data[]object[]

记录列表

chainstring示例solana

链标识

pairstring示例<pair_address>

币对或流动性池地址

target_tokenstring示例<token_address>

查询的代币地址

makerstring示例<maker_address>

操作钱包地址

sidestring示例remove

add / remove / unilateral_add / unilateral_remove

token0_addressstring示例<token0_address>

Token0 地址

amount0number示例16280.786976

Token0 增减数量

token1_addressstring示例So11111111111111111111111111111111111111…

Token1 地址

amount1number示例0.014062683

Token1 增减数量

block_numberinteger示例441761116

区块高度

txn_hashstring示例<transaction_hash>

交易哈希

block_timestampinteger示例1787708722

区块时间(Unix 秒)

tags[]string[]

地址或事件标签

dexstring示例meteora_dlmm

DEX 协议标识

total_volume_usdnumber示例5.513285266738132

本次流动性事件美元金额

token_pricenumber示例0.0002548183029809168

事件发生时代币美元价格

token0_symbolstring示例TOKEN

Token0 代码

token1_symbolstring示例WSOL

Token1 代码

错误与降级

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。