DEX pool流动性增减记录
查询代币的 DEX pool 流动性增减记录。
GET/api/v1/markets/dex/liquidity-events
可查询数据
- 返回数据
- 代币的 DEX pool 流动性增减记录
- 市场覆盖
- Crypto
- 查询粒度
- 每次查询一个资产或链上代币部署；每条记录对应一次流动性增减事件
认证
所有请求需携带 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示例5000可选流动性事件美元金额下限，仅返回大于该值的记录。
分页
page_indexintegerquery示例1可选页码，从 1 开始。
page_sizeintegerquery示例15可选每页返回数量。
响应
codeinteger示例0业务状态码，0 表示成功。
reasonstring原因说明。
messagestring示例success响应消息。
data[]object[]
记录列表。
chainstring示例solana链标识。
pairstring示例<pair_address>币对或流动性池地址。
target_tokenstring示例<token_address>查询的代币地址。
makerstring示例<maker_address>操作钱包地址。
sidestring示例removeadd / remove / unilateral_add / unilateral_remove
token0_addressstring示例<token0_address>Token0 地址。
amount0number示例16280.786976Token0 增减数量。
token1_addressstring示例So11111111111111111111111111111111111111…Token1 地址。
amount1number示例0.014062683Token1 增减数量。
block_numberinteger示例441761116区块高度。
txn_hashstring示例<transaction_hash>交易哈希。
block_timestampinteger示例1787708722区块时间（Unix 秒）。
tags[]string[]地址或事件标签。
dexstring示例meteora_dlmmDEX 协议标识。
total_volume_usdnumber示例5.513285266738132本次流动性事件美元金额。
token_pricenumber示例0.0002548183029809168事件发生时代币美元价格。
token0_symbolstring示例TOKENToken0 代码。
token1_symbolstring示例WSOLToken1 代码。
错误与降级
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。