跳到主内容
智客 ZICQ

技能库 智客分类:Agent 工作流 coinglass

Coinglass

加密衍生工具数据:供资率,开出利息,清算,长/短比率.

11468 安装量

官方网址:skills.sh

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

加密衍生工具数据:供资率,开出利息,清算,长/短比率.

何时用

眼镜

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Plan 权限分级(平台 key = Startup 级,2026-09 实测)、Liquidation Heatmap(❌ Startup 不可用 — 历史用法存档)、以下仅在用户自有高级 key 下可用(直连,不走 sc-proxy)、全市场聚合热力图(推荐,无需指定交易所)、range 支持: 12h, 24h, 3d, 7d, 30d, 90d, 180d, 1y、返回结构:。

文件分析

文件分析:这是一份仅含 SKILL.md 的指令型技能,代理激活后整份正文进入上下文。 正文约 742 行,超过规范建议的 500 行,激活时仍会整份载入。

官方 description(原文)

Crypto derivatives data: funding rates, open interest, liquidations, long/short ratios.

Plan 权限分级(平台 key = Startup 级,2026-09 实测)Liquidation Heatmap(❌ Startup 不可用 — 历史用法存档)以下仅在用户自有高级 key 下可用(直连,不走 sc-proxy)全市场聚合热力图(推荐,无需指定交易所)range 支持: 12h, 24h, 3d, 7d, 30d, 90d, 180d, 1y返回结构:data["y_axis"] → 价格档位列表(从低到高)data["liquidation_leverage_data"] → [[y_idx, leverage, usd_value], ...]data["price_candlesticks"] → OHLCV K线,最后一根收盘价 = 当前价data["update_time"] → 更新时间戳解析方法:Script Usage

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
coinglass
description
Crypto derivatives data: funding rates, open interest, liquidations, long/short ratios.
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「coinglass」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-3978717a9f900460-%E7%9C%BC%E9%95%9C.html
请存为 .cursor/skills/coinglass/SKILL.md 或 .claude/skills/coinglass/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。

npx skills add 'https://github.com/starchild-ai-agent/official-skills' --list

npx skills add 'https://github.com/starchild-ai-agent/official-skills' --skill 'coinglass'

CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。

阅读排版

name: coinglass version: 3.1.0 description: | Crypto derivatives data: funding rates, open interest, liquidations, long/short ratios.

Use when researching perp markets or comparing ETF flows (e.g. BTC funding, ETH OI). NOTE: platform API key is Startup tier — liquidation heatmap, coins-markets detail, liquidation order book and Hyperliquid positions require higher plans (see Plan 权限分级). delivery: script metadata: starchild: emoji: 📈 skillKey: coinglass plan: startup api_version: v4 version: 3.1.0 total_tools: 37 requires: env: - COINGLASS_API_KEY user-invocable: false disable-model-invocation: false


Plan 权限分级(平台 key = Startup 级,2026-09 实测)

平台注入的 COINGLASS_API_KEY 已降级为 Startup 计划。工具层对端点的实际权限:

✅ Startup 可用(全部正常数据):

  • Funding rates(v2/v4)、Supported coins/exchanges/pairs、Pairs markets
  • Open interest(当前值 / OHLC history / aggregated history)
  • Long/Short ratios(global / top-account / top-position)
  • Taker buy/sell volume(单所 + aggregated,需 exchange_list)
  • CVD、Net position(v1/v2)、Coin netflow
  • Liquidations:coin-list、coin/pair history(pair 需 BTCUSDT 格式)、aggregated history(需 exchange_list)
  • ETF flows / lists / premium(BTC、ETH、SOL、XRP、HK)
  • Whale transfers、Hyperliquid whale alerts(仅 alert 流)
  • Price history(symbol 需 pair 格式 BTCUSDT)

❌ Startup 不可用(401 "Upgrade plan",调用前直接跳过):

  • api/futures/coins-markets(币种市场汇总)
  • api/futures/liquidation/order(逐笔清算单)
  • api/futures/liquidation/heatmap/model1 + aggregated-heatmap/model1(清算热力图整个不可用)
  • api/hyperliquid/position、api/hyperliquid/wallet/position-distribution(Hyperliquid 持仓分布;仅 whale-alert 可用)

替代方案(按优先级):

  1. 用户提供自己的 key(Basic+ 计划):设 COINGLASS_API_KEY 并绕过 sc-proxy 直连 https://open-api-v4.coinglass.com(sc-proxy 会强制覆盖该 header,代理路径下自带 key 无效)。
  2. Apify 爬虫:用 apify skill 抓 coinglass.com 页面上的清算热力图 / Hyperliquid 持仓数据。

对 401 "Upgrade plan" 错误,cg_request 会抛 CoinglassPlanError,错误信息已含上述引导。

Liquidation Heatmap(❌ Startup 不可用 — 历史用法存档)

cg_liquidation_analysis 返回全0,不可用。热力图两个端点(heatmap/model1 与 aggregated-heatmap/model1)在 Startup 计划下均返回 401 Upgrade plan。

如需热力图数据:让用户自带 Basic+ key 直连(见上文替代方案),或用 Apify 爬取页面。

# 以下仅在用户自有高级 key 下可用(直连,不走 sc-proxy)
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"]               → 更新时间戳

# 解析方法:
from collections import defaultdict
y_axis = data["y_axis"]
current_price = float(data["price_candlesticks"][-1][4])
price_liq = defaultdict(float)
for y_idx, leverage, usd_val in data["liquidation_leverage_data"]:
    if 0 <= y_idx < len(y_axis):
        price_liq[y_axis[y_idx]] += usd_val

longs  = {p: v for p, v in price_liq.items() if p < current_price}  # 多头清算(↓触发)
shorts = {p: v for p, v in price_liq.items() if p > current_price}  # 空头清算(↑触发)

Script Usage

Script-mode skill — read this file, then invoke from a bash block:

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/coinglass")
from exports import funding_rate, cg_open_interest, cg_liquidations

print(funding_rate(symbol="BTC"))
print(cg_open_interest(symbol="BTC"))
EOF

Read exports.py for the full list of available functions and exact signatures. Common ones: funding_rate, long_short_ratio, cg_open_interest, cg_liquidations, cg_liquidation_analysis, cg_global_account_ratio, cg_top_account_ratio, cg_top_position_ratio, cg_taker_exchanges, cg_net_position, cg_supported_coins, cg_supported_exchanges, cg_coins_market_data, cg_pair_market_data, cg_ohlc_history, cg_hyperliquid_whale_alerts, cg_hyperliquid_whale_positions, cg_taker_volume_history, cg_aggregated_taker_volume, cg_cumulative_volume_delta, cg_coin_netflow, cg_whale_transfers, cg_btc_etf_flows, cg_eth_etf_flows, cg_sol_etf_flows.

Coinglass

Coinglass provides the most comprehensive crypto derivatives and institutional data available. 37 tools covering futures positioning, whale tracking, volume analysis, liquidations, and ETF flows.

API Plan: Startup (平台 key 已降级,见顶部「Plan 权限分级」) Rate Limit: 请求级限制随计划降低,控制批量调用频率 API Version: V4 (with V2 backward compatibility) Total Tools: 37 across 8 categories

Function Reference (full signatures + return shapes)

All functions live in exports.py. Most return Optional[List[Dict]] or Optional[Dict]. None means the upstream call failed or returned empty — always check before indexing.

⚠️ Field naming convention (READ THIS FIRST)

CoinGlass v4 API uses camelCase for almost all data fields, with a few legacy snake_case exceptions in liquidation endpoints. Don't assume snake_case — inspect the dict before scripting.

  • camelCase: openInterest, volUsd, longRate, shortVolUsd, exchangeName, nextFundingTime, fundingIntervalHours, oichangePercent, h4OIChangePercent, avgFundingRateBySymbol, tokenAmount, liquidationUsd (in some endpoints)
  • snake_case (legacy, only in cg_liquidations): liquidation_usd, longLiquidation_usd, shortLiquidation_usd
  • rate fields (funding) are STRINGS with "+" / "-" / "%" — parse with float(r.rstrip('%').lstrip('+')) to compare numerically
  • timestamps are millisecond unix epoch (e.g. 1777881600000)

Funding & Open Interest

| Function | Signature | |---|---| | funding_rate(symbol, exchange=None) | dict — keys: symbol, exchange, rate (str), num_exchanges, exchanges_data (list of {exchangeName, rate, nextFundingTime, fundingIntervalHours, status}) | | cg_open_interest(symbol='BTC', interval='0') | LIST of dicts (one per exchange) — keys: symbol, openInterest, volUsd, oichangePercent, h4OIChangePercent, h24VolChangePercent, volChangePercent7d, avgFundingRateBySymbol, exchangeName, exchangeLogo |

Long/Short Ratios

| Function | Signature | |---|---| | long_short_ratio(symbol='BTC', interval='h4') | LIST — top item is aggregated; list field inside has per-exchange breakdown. Keys: longRate, shortRate, longVolUsd, shortVolUsd, totalVolUsd, list | | cg_global_account_ratio(symbol='BTC', exchange='Binance', interval='1h') | list of historical bars | | cg_top_account_ratio(symbol='BTC', exchange='Binance', interval='1h') | list — top trader account-count ratio | | cg_top_position_ratio(symbol='BTC', exchange='Binance', interval='1h') | list — top trader position-size ratio | | cg_taker_exchanges(symbol='BTC', range_type='4h') | list — taker buy/sell across exchanges | | cg_net_position(symbol='BTC', exchange='Binance', interval='1h') | list — net long-short USD over time |

Liquidations

| Function | Signature | |---|---| | cg_liquidations(symbol='BTC', time_type='h24') | LIST of dicts (one per exchange + an 'All' row first). Keys: exchange, liquidation_usd, longLiquidation_usd, shortLiquidation_usd (NOTE: snake_case legacy fields) | | cg_liquidation_analysis(symbol='BTC', time_type='h24') | dict — aggregated network-wide stats | | cg_coin_liquidation_history(symbol='BTC', interval='h4') | list — historical liq bars | | cg_pair_liquidation_history(symbol='BTC', exchange='Binance', interval='h4') | list — historical liq for one pair on one exchange | | cg_liquidation_coin_list(symbol=None) | list of all coins with liq summary | | cg_liquidation_orders(symbol='BTC', exchange=None) | list — recent individual liq orders |

Futures Market Data

| Function | Signature | |---|---| | cg_supported_coins() | List[str] — symbols supported by CoinGlass | | cg_supported_exchanges() | list of exchange info dicts | | cg_coins_market_data(symbol=None) | list — current snapshot for all coins (or one if symbol given) | | cg_pair_market_data(symbol='BTC', exchange=None) | list — pair-level snapshot | | cg_ohlc_history(symbol='BTC', interval='h4', exchange=None) | list of OHLCV bars |

Hyperliquid Whale Tracking

| Function | Signature | |---|---| | cg_hyperliquid_whale_alerts() | list — recent large-position alerts | | cg_hyperliquid_whale_positions() | list — current open whale positions | | cg_hyperliquid_positions_by_coin(symbol='BTC') | list — whales holding a specific coin | | cg_hyperliquid_position_distribution(symbol='BTC') | dict — long/short position-size distribution |

Volume / Flow

| Function | Signature | |---|---| | cg_taker_volume_history(symbol='BTC', exchange='Binance', interval='1h', limit=1000, start_time=None, end_time=None) | list — taker buy/sell volume bars | | cg_aggregated_taker_volume(symbol='BTC', interval='h4') | list — aggregated across all exchanges | | cg_cumulative_volume_delta(symbol='BTC', exchange='Binance', interval='1h', limit=1000, start_time=None, end_time=None) | list — CVD bars | | cg_coin_netflow(symbol=None) | list — net inflow/outflow per coin | | cg_whale_transfers() | dict — recent on-chain large transfers |

ETF Flows

| Function | Signature | |---|---| | cg_btc_etf_flows() | list — daily flows per US BTC ETF | | cg_btc_etf_history(etf_ticker=None) | list — historical AUM/flows | | cg_btc_etf_list() | list of BTC ETF tickers + AUM | | cg_btc_etf_premium_discount() | list — premium/discount % vs NAV | | cg_hk_btc_etf_flows() | list — Hong Kong BTC ETF flows | | cg_eth_etf_flows() / cg_eth_etf_list() / cg_eth_etf_premium_discount() / cg_hk_eth_etf_flows() | ETH ETF equivalents | | cg_sol_etf_flows() / cg_sol_etf_list() | SOL ETF data | | cg_xrp_etf_flows() / cg_xrp_etf_list() | XRP ETF data |

Sample responses (most-used functions)

funding_rate(symbol="BTC"):

{
  "symbol": "BTC",
  "exchange": "average",
  "rate": "-0.0016%",
  "num_exchanges": 21,
  "exchanges_data": [
    {"exchangeName": "Binance", "rate": "+0.0050%",
     "nextFundingTime": 1777881600000, "fundingIntervalHours": 8, "status": 1}
  ]
}

cg_liquidations(symbol="BTC", time_type="h24"):

[
  {"exchange": "All", "liquidation_usd": 170497688.16,
   "longLiquidation_usd": 8179073.80, "shortLiquidation_usd": 162318614.36},
  {"exchange": "Bybit", "liquidation_usd": 40454694.98, ...}
]

cg_open_interest(symbol="BTC"):

[
  {"symbol": "BTC", "openInterest": 61395303653.62, "volUsd": 56349328748.42,
   "oichangePercent": 7.17, "h4OIChangePercent": 5.33,
   "avgFundingRateBySymbol": -0.001874, "exchangeName": "Binance"}
]

long_short_ratio(symbol="BTC", interval="h4"):

[{
  "symbol": "BTC", "longRate": 53.65, "shortRate": 46.35,
  "longVolUsd": 12558668895.91, "shortVolUsd": 10848776476.99,
  "totalVolUsd": 23407445372.91,
  "list": [
    {"exchangeName": "Binance", "longRate": 55.75, "shortRate": 44.25, ...}
  ]
}]

Tool Selection Guide

Decision Tree

Step 1: Is this about LIQUIDATIONS?

Liquidation query?
├─ YES → How many coins?
│   ├─ ALL coins / ranking / 排行 / 汇总
│   │   └─ → cg_liquidation_coin_list  ✅ (most liquidation queries land here)
│   ├─ ONE coin, need history over time
│   │   └─ → cg_coin_liquidation_history
│   ├─ ONE coin, specific orders (price/side/USD)
│   │   └─ → cg_liquidation_orders
│   └─ ONE coin, just a quick total + sentiment label
│       └─ → cg_liquidation_analysis  (rarely needed; only if explicitly "simple summary")

Step 2: Is this about LONG/SHORT RATIO?

Long/short query?
├─ Historical time-series, trend over time, 多空比变化
│   └─ → cg_global_account_ratio  (ALL accounts)
│      or cg_top_account_ratio    (top traders only)
│      or cg_top_position_ratio   (by position size)
└─ Current snapshot only (no history needed)
    └─ → long_short_ratio

Step 3: Is this about OPEN INTEREST?

OI query?
└─ → cg_open_interest  (always — do NOT use cg_coins_market_data for OI)

Step 4: Is this a MARKET OVERVIEW / SENTIMENT query?

Sentiment / 市场情绪 / pre-trade check?
└─ Use: funding_rate + long_short_ratio + cg_open_interest
   DO NOT use cg_coins_market_data as a substitute for any of the above

Keyword → Tool Lookup

| Keyword / Pattern | Correct Tool | ❌ Do NOT use | |---|---|---| | 爆仓排行 / 今日爆仓 / all coins liquidation | cg_liquidation_coin_list | cg_liquidations | | 24h爆仓汇总 / liquidation summary | cg_liquidation_coin_list | cg_liquidation_analysis | | 全网账户多空比 / account L/S ratio | cg_global_account_ratio | long_short_ratio | | 头部交易者多空 / top trader ratio | cg_top_account_ratio | long_short_ratio | | 未平仓合约 / open interest | cg_open_interest | cg_coins_market_data | | 市场情绪多空分析 | funding_rate + long_short_ratio + cg_open_interest | cg_coins_market_data | | BTC做多检查 / pre-trade checklist | funding_rate + cg_global_account_ratio + cg_liquidation_coin_list | — |


Common Mistakes

Mistake 1 (most common — 8x failure): Using cg_liquidations when you need cg_liquidation_coin_list

  • cg_liquidations → one coin, one timeframe, basic total only
  • cg_liquidation_coin_list(exchange) → ALL coins, multi-timeframe (1h/4h/12h/24h), per-exchange breakdown
  • Rule: If the question asks for a ranking, overview, or doesn't specify a single coin → use cg_liquidation_coin_list

Mistake 2 (5x failure): Using cg_liquidation_analysis for liquidation rankings

  • cg_liquidation_analysis adds a sentiment label to a single-coin total — it is NOT a ranking tool
  • Rule: "今日爆仓排行" / "各币种爆仓" → always cg_liquidation_coin_list

Mistake 3 (3x failure): Using long_short_ratio for historical L/S analysis

  • long_short_ratio is a current snapshot (no time-series)
  • cg_global_account_ratio returns history — use it when the user wants trends or comparison over time
  • Rule: If the question compares 全网 (global) vs 头部 (top traders) → call BOTH cg_global_account_ratio AND cg_top_account_ratio

Mistake 4 (2x failure): Using cg_coins_market_data for open interest

  • cg_coins_market_data is a bulk snapshot of many coins — not a replacement for dedicated OI or L/S tools
  • Rule: OI question → cg_open_interest. L/S question → long_short_ratio or cg_global_account_ratio. Never route either to cg_coins_market_data.

Rules

Tool Call Guidance

❌ FORBIDDEN TOOLS — NEVER USE:

  • bash — Do NOT write scripts to process/format data. Use natural language.
  • write_file / read_file / edit_file — Do NOT save intermediate data. Answer directly.
  • learning_log — ONLY for genuine skill bugs or persistent API errors. NOT for empty responses.
  • echo — Do NOT use for debugging or output.

✅ CORRECT PATTERN:

  • Tool returns data → Summarize in natural language → Done
  • Tool returns empty/null → Report "no data available" → Done
  • Need calculation (%, change, ratio) → Do mental math in reply

Match tool count to question scope:

  • 单一指标问题("BTC 资金费率"、"ETH 多空比")→ 1 个工具,直接返回
  • 多维度分析("做多是否合适"、"衍生品体检")→ 3-5 个工具,综合分析
  • 对比问题("ETH vs SOL")→ 每个币种调相同工具,并列对比
  • 避免重复调用同一工具。 除非用户明确要求不同币种/交易所的对比。

Learning Log Usage (CRITICAL)

learning_log is FORBIDDEN for:

  • ❌ Empty API responses — just report "no data available"
  • ❌ Tool returning None/null — handle gracefully
  • ❌ Uncertainty about tool selection — check decision tree first
  • ❌ Normal tool errors — retry once, then report failure

learning_log is ONLY for:

  • ✅ Genuine bugs in skill code (wrong data format returned)
  • ✅ Persistent API rate limit errors after 2+ retries
  • ✅ Missing tools that should exist per skill definition

ETF Tool Selection

| Query | Primary Tool | Secondary Tool | |-------|--------------|----------------| | BTC ETF 资金流入/流出 | cg_btc_etf_flows() | cg_btc_etf_history() for detailed history | | ETH ETF 资金流入/流出 | cg_eth_etf_flows() | — | | SOL/XRP ETF flows | cg_sol_etf_flows() / cg_xrp_etf_flows() | — | | HK ETF flows | cg_hk_btc_etf_flows() / cg_hk_eth_etf_flows() | — | | ETF 列表/代码 | cg_btc_etf_list() / cg_eth_etf_list() | — | | ETF 溢价/折价 | cg_btc_etf_premium_discount() | — |

ETF 对比问题 workflow:

# BTC vs ETH ETF 对比
btc = cg_btc_etf_flows()
eth = cg_eth_etf_flows()
# Compare the latest day's net flows, summarize in 2-3 sentences

Quick Routing (use this first)

| Query type | Tool | |---|---| | 爆仓/liquidation summary (24h, by coin) | cg_liquidation_coin_list | | Individual liquidation orders | cg_liquidation_orders | | Liquidation history for a coin | cg_coin_liquidation_history | | Funding rate | funding_rate | | Long/short ratio (global) | cg_global_account_ratio | | Open interest | cg_open_interest | | Whale activity on Hyperliquid | cg_hyperliquid_whale_alerts | | ETF flows (BTC) | cg_btc_etf_flows |

When to Use Coinglass

Use Coinglass for:

  • Derivatives positioning - What are leveraged traders doing?
  • Whale tracking - Track large positions on Hyperliquid DEX
  • Funding rates - Cost of holding perpetual futures
  • Open interest - Total notional value of open positions
  • Long/Short ratios - Sentiment among leveraged traders (global, top accounts, top positions)
  • Liquidations - Forced position closures with heatmaps and individual orders
  • Volume analysis - Taker volume, CVD, netflow patterns
  • ETF flows - Institutional adoption (Bitcoin, Ethereum, Solana, XRP, Hong Kong)
  • Whale transfers - Large on-chain movements (>$10M)
  • Futures market data - Supported coins, exchanges, pairs, and OHLC price history

Tool Categories

1. Basic Derivatives Analytics (7 tools)

Core derivatives data for market analysis:

  • funding_rate(symbol, exchange?) - Current funding rates
  • long_short_ratio(symbol, exchange?, interval?) - Basic L/S ratios
  • cg_open_interest(symbol) - Current OI across exchanges
  • cg_liquidations(symbol, time?) - Recent liquidations
  • cg_liquidation_analysis(symbol) - ❌ Startup 下不可用(依赖 heatmap 端点)
  • cg_supported_coins() - All supported coins
  • cg_supported_exchanges() - All exchanges with pairs

2. Advanced Long/Short Ratios (6 tools)

Deep positioning analysis with multiple metrics:

  • cg_global_account_ratio(symbol, interval?) - Global account-based L/S ratio
  • cg_top_account_ratio(symbol, exchange, interval?) - Top trader accounts ratio
  • cg_top_position_ratio(symbol, exchange, interval?) - Top positions by size
  • cg_taker_exchanges(symbol) - Taker buy/sell by exchange
  • cg_net_position(symbol, exchange) - Net long/short positions
  • cg_net_position_v2(symbol) - Enhanced net position data

Use cases:

  • Smart money tracking (top accounts vs retail)
  • Exchange-specific sentiment
  • Position size distribution analysis

3. Advanced Liquidations (4 tools)

Granular liquidation tracking for cascade prediction:

  • cg_coin_liquidation_history(symbol, interval?, limit?, start_time?, end_time?) - Aggregated across all exchanges
  • cg_pair_liquidation_history(symbol, exchange, interval?, limit?, start_time?, end_time?) - Exchange-specific pair
  • cg_liquidation_coin_list(exchange) - All coins on an exchange
  • cg_liquidation_orders(symbol, exchange, min_liquidation_amount, start_time?, end_time?) - Individual orders (past 7 days, max 200)

Use cases:

  • Identifying liquidation clusters
  • Tracking liquidation patterns over time
  • Finding large liquidation events

4. Hyperliquid Whale Tracking (4 tools)

Track large traders on Hyperliquid DEX (~200 recent alerts):

  • cg_hyperliquid_whale_alerts() - Recent large position opens/closes (>$1M)
  • cg_hyperliquid_whale_positions() - Current whale positions with PnL
  • cg_hyperliquid_positions_by_coin() - All positions grouped by coin
  • cg_hyperliquid_position_distribution() - Distribution by size with sentiment

Use cases:

  • Following smart money on Hyperliquid
  • Detecting large position changes
  • Tracking whale PnL and sentiment

5. Futures Market Data (5 tools)

Market overview and price data:

  • cg_coins_market_data() - ALL coins data in one call (100+ coins)
  • cg_pair_market_data(symbol, exchange) - Specific pair metrics
  • cg_ohlc_history(symbol, exchange, interval, limit?) - OHLC candlesticks
  • cg_taker_volume_history(symbol, exchange, interval, limit?, start_time?, end_time?) - Pair-specific taker volume
  • cg_aggregated_taker_volume(symbol, interval, limit?, start_time?, end_time?) - Aggregated across exchanges

Use cases:

  • Market screening (scan all coins at once)
  • Price action analysis
  • Volume pattern recognition

6. Volume & Flow Analysis (4 tools)

Order flow and capital movement tracking:

  • cg_cumulative_volume_delta(symbol, exchange, interval, limit?, start_time?, end_time?) - CVD = Running total of (buy - sell)
  • cg_coin_netflow() - Capital flowing into/out of coins
  • cg_whale_transfers() - Large on-chain transfers (>$10M, past 6 months)

Use cases:

  • Order flow divergence detection
  • Smart money tracking
  • Institutional movement monitoring

7. Bitcoin ETF Data (5 tools)

Track institutional Bitcoin adoption:

  • cg_btc_etf_flows() - Daily net inflows/outflows
  • cg_btc_etf_premium_discount() - ETF price vs NAV
  • cg_btc_etf_history() - Comprehensive history (price, NAV, premium%, shares, assets)
  • cg_btc_etf_list() - List of Bitcoin ETFs
  • cg_hk_btc_etf_flows() - Hong Kong Bitcoin ETF flows

Use cases:

  • Institutional demand tracking
  • Premium/discount arbitrage
  • Regional flow comparison (US vs Hong Kong)

8. Other ETF Data (8 tools)

Ethereum, Solana, XRP, and Hong Kong ETFs:

  • cg_eth_etf_flows() - Ethereum ETF flows
  • cg_eth_etf_list() - Ethereum ETF list
  • cg_eth_etf_premium_discount() - ETH ETF premium/discount
  • cg_sol_etf_flows() - Solana ETF flows
  • cg_sol_etf_list() - Solana ETF list
  • cg_xrp_etf_flows() - XRP ETF flows
  • cg_xrp_etf_list() - XRP ETF list
  • cg_hk_eth_etf_flows() - Hong Kong Ethereum ETF flows

Use cases:

  • Multi-asset institutional tracking
  • Comparative flow analysis
  • Regional preference analysis

Common Workflows

Quick Market Scan

# Get everything in 3 calls
all_coins = cg_coins_market_data()  # 100+ coins with full metrics
btc_liquidations = cg_liquidations("BTC")
whale_alerts = cg_hyperliquid_whale_alerts()

Deep Position Analysis

# BTC positioning across metrics
cg_global_account_ratio("BTC")  # Retail sentiment
cg_top_account_ratio("BTC", "Binance")  # Smart money
cg_net_position_v2("BTC")  # Net positioning
# 注:清算热力图在 Startup 下不可用,见顶部「Plan 权限分级」

ETF Flow Monitoring

# Institutional demand
btc_flows = cg_btc_etf_flows()
eth_flows = cg_eth_etf_flows()
sol_flows = cg_sol_etf_flows()

Whale Tracking

# Follow the whales
hyperliquid_whales = cg_hyperliquid_whale_alerts()
whale_positions = cg_hyperliquid_whale_positions()
onchain_whales = cg_whale_transfers()  # >$10M on-chain

Volume Analysis

# Order flow
cvd = cg_cumulative_volume_delta("BTC", "Binance", "1h", 100)
netflow = cg_coin_netflow()  # All coins
taker_vol = cg_aggregated_taker_volume("BTC", "1h", 100)

Interpretation Guides

Funding Rates

| Rate (8h) | Read | |------------|------| | > +0.05% | Extreme greed — crowded long, squeeze risk | | +0.01% to +0.05% | Bullish bias, normal | | -0.005% to +0.01% | Neutral | | -0.05% to -0.005% | Bearish bias, normal | | < -0.05% | Extreme fear — crowded short, bounce risk |

Extreme funding often precedes reversals. The crowd is usually wrong at extremes.

Open Interest + Price Matrix

| OI | Price | Read | |----|-------|------| | Up | Up | New longs entering — bullish conviction | | Up | Down | New shorts entering — bearish conviction | | Down | Up | Short covering — weaker rally, less conviction | | Down | Down | Long liquidation — weaker selloff, capitulation |

Long/Short Ratio

| Ratio | Read | |-------|------| | > 1.5 | Crowded long — contrarian bearish | | 1.1–1.5 | Moderately bullish | | 0.9–1.1 | Balanced | | 0.7–0.9 | Moderately bearish | | < 0.7 | Crowded short — contrarian bullish |

CVD (Cumulative Volume Delta)

| Pattern | Read | |---------|------| | CVD rising, price rising | Strong buy pressure, healthy uptrend | | CVD falling, price rising | Weak rally, distribution | | CVD rising, price falling | Accumulation, potential bottom | | CVD falling, price falling | Strong sell pressure, healthy downtrend |

ETF Flows

| Flow | Read | |------|------| | Large inflows | Institutional buying, bullish | | Consistent inflows | Sustained demand | | Large outflows | Institutional selling, bearish | | Premium to NAV | High demand, bullish sentiment | | Discount to NAV | Weak demand, bearish sentiment |

Analysis Patterns

Multi-metric confirmation: Combine tools across categories for high-confidence signals:

  • Funding + L/S ratio + liquidations = positioning extremes
  • CVD + taker volume + whale alerts = smart money direction
  • ETF flows + whale transfers + open interest = institutional conviction

Smart money vs retail: Compare metrics to identify divergence:

  • cg_top_account_ratio (smart money) vs cg_global_account_ratio (retail)
  • Hyperliquid whale positions vs overall long/short ratios

Cascade prediction: Use liquidation tools to predict volatility:

  • cg_coin_liquidation_history shows liquidation patterns over time
  • cg_liquidation_orders reveals recent forced closures
  • Large liquidation events = cascade risk zones

Flow divergence: Track capital movements:

  • cg_coin_netflow shows where money is flowing
  • cg_whale_transfers reveals large movements
  • ETF flows show institutional demand

Performance Optimization

Batch vs Individual Calls

✅ OPTIMAL: Use batch endpoints

# One call gets 100+ coins
all_coins = cg_coins_market_data()

# One call gets all whale alerts
whales = cg_hyperliquid_whale_alerts()

# One call gets all ETF flows
btc_etf = cg_btc_etf_flows()

❌ INEFFICIENT: Multiple individual calls

# Don't do this - wastes API quota
btc = cg_pair_market_data("BTC", "Binance")
eth = cg_pair_market_data("ETH", "Binance")
sol = cg_pair_market_data("SOL", "Binance")

Query Parameters

Most history endpoints support:

  • interval: Time granularity (1h, 4h, 12h, 24h, etc.)
  • limit: Number of records (default varies, max 1000)
  • start_time: Unix timestamp (milliseconds)
  • end_time: Unix timestamp (milliseconds)

Example:

cg_coin_liquidation_history(
    symbol="BTC",
    interval="1h",
    limit=100,
    start_time=1704067200000,  # 2024-01-01
    end_time=1704153600000     # 2024-01-02
)

Supported Exchanges

Major exchanges with futures data:

  • Tier 1: Binance, OKX, Bybit, Gate, KuCoin, MEXC
  • Traditional: CME (Bitcoin and Ethereum futures), Coinbase
  • DEX: Hyperliquid, dYdX, ApeX
  • Others: Bitfinex, Kraken, HTX, BingX, Crypto.com, CoinEx, Bitget

Use cg_supported_exchanges() for complete list with pair details.

Important Notes

  • API Key: Requires COINGLASS_API_KEY environment variable
  • Symbols: Use standard symbols (BTC, ETH, SOL, etc.) - check with cg_supported_coins()
  • Exchanges: Check cg_supported_exchanges() for full list with pairs
  • Update Frequency:
    • Market data: ≤ 1 minute
    • Funding rates: Every 8 hours (or 1 hour for some exchanges)
    • OHLC: Real-time to 1 minute depending on interval
    • ETF data: Daily (after market close)
    • Whale transfers: Real-time (within minutes)
  • API Versions:
    • V4 endpoints use CG-API-KEY header (most tools)
    • V2 endpoints use coinglassSecret header (some legacy tools)
    • Both work with the same COINGLASS_API_KEY environment variable
  • Rate Limits: Startup plan — keep batch polling modest; avoid tight loops
  • Historical Data Limits:
    • Liquidation orders: Past 7 days, max 200 records
    • Whale transfers: Past 6 months, minimum $10M
    • Hyperliquid alerts: ~200 most recent large positions
    • Other endpoints: Typically months to years of history
  • Plan gating (Startup): heatmap、liquidation/order、coins-markets、 Hyperliquid position 返回 401 Upgrade plan(会抛 CoinglassPlanError)。 用户需要这些数据 → 让用户提供自己的 key(COINGLASS_DIRECT=1 + 自有 COINGLASS_API_KEY 直连),或用 Apify skill 爬 coinglass.com 页面。

Data Quality Notes

  • Hyperliquid: Data is exchange-specific, doesn't include other DEXs
  • Whale Transfers: Covers Bitcoin, Ethereum, Tron, Ripple, Dogecoin, Litecoin, Polygon, Algorand, Bitcoin Cash, Solana
  • ETF Data: US ETFs updated after market close (4 PM ET), Hong Kong ETFs updated after Hong Kong market close
  • Liquidation Orders: Limited to 200 most recent, use heatmap for broader view
  • CVD: Cumulative metric - resets are not automatic, track changes not absolute values

Version History

  • v3.1.0 (2026-09): Startup plan adaptation
    • Platform key downgraded to Startup; documented full endpoint permission map
    • Added CoinglassPlanError with BYOK / Apify guidance on 401 "Upgrade plan"
    • Added COINGLASS_DIRECT=1 direct mode for user-supplied keys (sc-proxy overwrites user keys)
    • Fixed 4 parameter bugs: coin/pair liquidation history (exchange_list / pair symbol), aggregated taker volume (exchange_list), price history (pair symbol)
  • v3.0.0 (2025-03): Added 36 new tools
    • Advanced liquidations (5 tools)
    • Hyperliquid whale tracking (5 tools)
    • Volume & flow analysis (5 tools)
    • Whale transfers (1 tool)
    • Bitcoin ETF (6 tools)
    • Other ETFs (8 tools)
    • Advanced L/S ratios (6 tools)
  • v2.2.0 (2024): V4 API migration with futures market data
  • v1.0.0 (2024): Initial release with basic derivatives data

相关技能

Agent 工作流

Skill Creator

创造有效技能指南。 当用户想创造出新的技能(或更新现有的技能),以专业知识,工作流程,或工具集成来扩展克洛德的能力时,应该使用这种技能.

Agent 工作流

Clawdhub

使用ClawdHub CLI搜索,安装,更新并发布从taladhub.com的代理技能. 需要获取苍蝇上的新技能时使用,将安装的技能同步到最新版本或特定版本,或者发布 npm-instainddhub CLI 的新/更新的技能文件夹.

Agent 工作流

Agent Team Orchestration

管弦乐团多代理团队,任务设定周期,交接协议,审查工作流程. 使用时间: (1)建立2+特派员队伍,具有不同专业,(2)确定任务路线和生命周期(收录框_ spec_建设_审查_完成),(3)在特派员之间制定交接协议,(4)建立审查和质量关口,(5)管理特派员之间的交流和文物共享.

Agent 工作流

Superpowers

Spec-first,TDD,子代理驱动的软件开发工作流程. 当:(1)构建任何新功能或应用——触发脑暴_计划_子代理执行回路,(2)调试出一个bug或测试失败——触发系统性的根起过程,(3)用户说"让我们构建","帮助我计划","我想添加X",或"这个被打破",(4)完成一个功…