GateData.AI

清算热力图

查询指定交易对象在价格区间内的多空清算强度分布，用于绘制清算热力图。

GET/api/v1/markets/liquidation-heatmap
数据域
行情与流动性
解析层级
Crypto 资产·价格区间
MCP 工具
market_data_query (task=liquidation_heatmap)

可查询数据

返回数据
指定交易对象在价格区间内的多空清算强度分布，用于绘制清算热力图
市场覆盖
Crypto 市场
查询粒度
每次查询一个资产和价格区间；网格用于热力图估算，不是已发生清算的逐笔记录

认证

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

请求参数

资产定位

至少填写一项：asset_id / query。

asset_idstringquery示例asset_btc条件必须

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

querystringquery示例BTC条件必须

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

响应

items[]array[object (LiquidationHeatmapItem)]

业务记录数组

price_levelnumber | null示例60244.95

热力图价格档位

y_indexinteger

热力图纵轴档位索引

liq_amount_usdnumber | null示例287566211.9399997

清算美元名义金额

estimated_liq_longnumber | null

估算的多头清算金额

estimated_liq_shortnumber | null

估算的空头清算金额

exchangestring | null

交易所或平台代码

rangestring示例3d

查询或模型覆盖范围

snapshot_timedatetime示例2026-08-17T16:00:00Z

盘口或模型的源快照时间

liquidation_24hnumber | null示例109064634278.62999

过去24小时清算金额

liquidation_windowstring示例24h

清算统计时间窗口

heatmap_rangestring | null示例3d

热力图覆盖范围

aggregation_scopestring示例all_cex

指标覆盖的聚合范围

data_statusDataStatus示例partial

业务数据可用状态

metadataobject

响应状态与解析信息容器

data_statusDataStatus示例partial

业务数据可用状态

missing_fields[]string[]示例estimated_liq_long

未返回的合同字段数组

actual_taskstring

实际执行的任务类型

route_reasonstring

任务或对象路由原因

limitations[]string[]示例data_partial

已知数据限制数组

updated_atdatetime | string示例2026-08-17T17:07:22Z

对象或响应最近更新时间

partialboolean示例true

响应是否仅含部分字段

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示例asset_entity

对象解析所用输入来源

resolution_confidencestring示例resolved

对象解析置信度

错误与降级

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。