跳转到主要内容
GET
Liquidity events
在此端点的代币、池和钱包范围内查询活动。使用 events=all 合并兑换交易与流动性增减,或使用 events=liquidity 仅获取流动性。省略 events 则保持仅返回兑换交易的行为。添加 enrich=identity 可获取两类记录的钱包身份。 流动性记录的类型为 add_liquidity 或 remove_liquidity,包含单个 pool 和 tokens[] 中的精确字符串数量,不含兑换价格、成交量或 PnL。REST 示例、分页和实时订阅请参阅流动性指南。

SDK Example

授权

x-api-key
string
header
必填

用于鉴权的 API Key

路径参数

tokenAddress
string
必填
poolAddress
string
必填
owner
string
必填

查询参数

events
enum<string>
默认值:trades

选择 trades(默认,仅兑换交易)、all(兑换与流动性)或 liquidity(仅流动性增减)。所有模式均返回 trades 数组。无效值返回 HTTP 400。

可用选项:
trades,
all,
liquidity
enrich
string

传入 identity,为每条交易或流动性记录添加当前钱包身份,包括可用的 KOL 资料、标签、交易平台、开发者/池标签和 SNS 名称。未知钱包返回 identity: null。省略时不查询身份。all 和 * 也启用身份;pool 和 developer 为兼容别名。

cursor
string

将 nextCursor 原样传回。默认交易模式使用时间戳;events=all 和 events=liquidity 返回不透明字符串,绑定代币、池、钱包、events 与 sortDirection。分页时请保持这些筛选不变。

limit
integer
默认值:250

结果数量默认 250,最多 500。events=all 或 events=liquidity 模式支持 1–500。

必填范围: 1 <= x <= 500
sortDirection
enum<string>
默认值:DESC

时间顺序:DESC(从新到旧)或 ASC(从旧到新)。无效值返回 HTTP 400。

可用选项:
ASC,
DESC
showMeta
boolean

设为 true,为兑换交易的来源与目标代币添加元数据。流动性记录保留 tokens 数组,不添加兑换元数据。

hideArb
boolean

设为 true,仅保留涉及请求代币的兑换交易。流动性操作不受影响。

currency
enum<string>

为每笔兑换添加 price(每个代币的价格),以交易发生时的该币种计价。sol:以 SOL 计价的交易直接使用兑换本身的 SOL 和代币数量;其他交易用美元价格除以当秒的 SOL/USD 汇率。eur:美元价格除以交易发生时的 EUR/USD 汇率。交易没有美元价格或没有可用汇率时,price 为 null。流动性记录不受影响。无效值返回 HTTP 400。

可用选项:
usd,
eur,
sol
marketCap
boolean
默认值:false

设为 true 可为每笔兑换添加 marketCap:price(以 currency 计价,默认美元)乘以代币主池的供应量。使用当前供应量,因此交易后发生过销毁或增发的代币按当前供应量计算。

响应

Successful response

trades
object[]
nextCursor

Timestamp for trades-only requests; opaque string for events=all/liquidity. Pass back unchanged with the same filters. Null at the end.

hasNextPage
boolean
sortDirection
enum<string>
可用选项:
ASC,
DESC
currency
enum<string>

price 和 marketCap 的计价币种。设置了 currency 或 marketCap 时返回。

可用选项:
usd,
eur,
sol