DEX pool流动性增减记录
查询代币的 DEX pool 流动性增减记录。
GET/api/v1/markets/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示例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。