coinglass

SKILL.md

Real-time crypto derivatives positioning, whale tracking, liquidations, and institutional ETF flows across 37 specialized tools.

37 tools across 8 categories: funding rates, long/short ratios, open interest, liquidations, Hyperliquid whale tracking, volume analysis, and Bitcoin/Ethereum/Solana/XRP ETF flows

Advanced positioning metrics include global account ratios, top trader ratios, net position tracking, and taker volume by exchange for smart money vs. retail divergence analysis

Liquidation tracking with historical data, heatmaps, and individual order details; whale transfer monitoring for on-chain movements above $10M

Batch endpoints like cg_coins_market_data() return 100+ coins in one call; supports OHLC history, cumulative volume delta, and premium/discount analysis for ETF arbitrage

Requires COINGLASS_API_KEY; professional plan allows 6000 requests/minute with real-time to daily update frequency depending on data type

Liquidation Heatmap（真正的价格区间清算压力）

cg_liquidation_analysis 返回全0，不可用。正确做法是直接调 API：

from tools._api import cg_request

# 全市场聚合热力图（推荐，无需指定交易所）
# range 支持: 12h, 24h, 3d, 7d, 30d, 90d, 180d, 1y
data = cg_request("api/futures/liquidation/aggregated-heatmap/model1",
                  params={"symbol": "BTC", "range": "24h"})

# 返回结构：
# data["y_axis"]                   → 价格档位列表（从低到高）
# data["liquidation_leverage_data"] → [[y_idx, leverage, usd_value], ...]
# data["price_candlesticks"]        → OHLCV K线，最后一根收盘价 = 当前价
# data["update_time"]               → 更新时间戳