GateData.AI

衍生品 · 清算聚合

查询不同时间颗粒度下的多空清算聚合数据，支持单交易对或币种跨交易所汇总。

GET/api/v1/markets/derivatives/liquidations/aggregates
数据域
行情与流动性
解析层级
Crypto 清算时间桶
MCP 工具
market_data_query (task=liquidation_aggregates)

可查询数据

返回数据
不同时间颗粒度下的多空清算聚合数据，支持单交易对或币种跨交易所汇总
市场覆盖
Crypto 衍生品市场
查询粒度
PAIR 返回单一交易所交易对；COIN 按币种跨交易所汇总；缺失时间桶不会补零

认证

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

请求参数

聚合范围

scope 必填。PAIR 查询单一交易所交易对；COIN 按币种汇总。

scopePAIR | COINquery示例COIN必填

PAIR 按交易所交易对聚合；COIN 按币种汇总。

资产定位

asset_id 与 query 至少填写一项。

asset_idstringquery示例asset_btc条件必须

资产标识，标识股票、加密资产等资产对象

querystringquery示例BTC条件必须

用于解析查询对象的检索词

交易所与交易对

PAIR 模式必须填写 venue 和 venue_symbol；COIN 模式可选 venue，且不能填写 venue_symbol。

venuestringquery示例binance条件必须

查询指定的交易场所代码

venue_symbolstringquery示例BTCUSDT条件必须

交易所交易对，例如 BTCUSDT。仅用于 PAIR，且在 PAIR 模式下必填。

时间范围与粒度

时间可用 Unix 毫秒或 RFC 3339；当前仅支持 1h 粒度。

interval1hquery示例1h可选

聚合时间粒度；当前仅支持 1h，默认 1h。

start_timestringquery示例1789977600000可选

查询时间范围起点

end_timestringquery示例1790582400000可选

查询时间范围终点

limitintegerquery示例1000可选

单次最多返回的记录数

响应

items[]object[]

清算金额时间桶列表

bucket_startinteger示例1789977600000

时间桶起点，Unix 毫秒

bucket_endinteger示例1789981200000

时间桶终点，Unix 毫秒

scopePAIR | COIN示例COIN

聚合范围

asset_idstring示例asset_btc

资产标识，标识股票、加密资产等资产对象

base_assetstring示例BTC

基础资产代码

venuestring示例binance

交易所代码

venue_symbolstring

PAIR 模式下的交易所交易对

long_liquidation_usdstring示例501202.3

多头仓位清算金额

short_liquidation_usdstring示例78877728

空头仓位清算金额

total_liquidation_usdstring示例79378930.3

多空清算总金额

intervalstring示例1h

时间桶粒度

start_timeinteger示例1789977600000

实际查询起始时间

end_timeinteger示例1790582400000

实际查询结束时间

coverageobject

请求区间与数据覆盖信息

disclaimerstring示例Missing buckets do not mean zero liquida…

聚合数据口径说明

metadataobject

响应状态与解析信息容器

data_statusDataStatus示例ready

业务数据可用状态

limitations[]string[]

已知数据限制数组

updated_atdatetime | string示例2026-09-28T08:26:01Z

对象或响应最近更新时间

partialboolean

响应是否仅含部分字段

resolution_reasonstring

对象解析结果的原因码

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例asset

对象引用类型

idstring示例asset_btc

对象标识，标识 type 指定的具体对象

entity_idstring

主体标识，标识公司、项目方或协议等主体

asset_idstring示例asset_btc

资产标识，标识股票、加密资产等资产对象

listing_idstring

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

instrument_idstring

交易工具标识，标识股票、现货交易对或合约等具体交易产品

venue_idstring

交易场所标识，标识交易所或交易平台

event_refstring

关联事件标识，标识与当前对象关联的事件

market_idstring

预测市场标识，标识预测事件下的具体市场

venuestring

对象关联的平台代码

resolved_fromstring

对象解析所用输入来源

resolution_confidencestring

对象解析置信度

错误与降级

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。