🇺🇸English
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 : Professional ($699/month) Rate Limit : 6000 requests/minute API Version : V4 (with V2 backward compatibility) Total Tools : 37 across 8 categories
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 rateslong_short_ratio(symbol, exchange?, interval?) - Basic L/S ratioscg_open_interest(symbol) - Current OI across exchangescg_liquidations(symbol, time?) - Recent liquidationscg_liquidation_analysis(symbol) - Liquidation heatmap analysiscg_supported_coins() - All supported coinscg_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 ratiocg_top_account_ratio(symbol, exchange, interval?) - Top trader accounts ratiocg_top_position_ratio(symbol, exchange, interval?) - Top positions by sizecg_taker_exchanges(symbol) - Taker buy/sell by exchangecg_net_position(symbol, exchange) - Net long/short positionscg_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 exchangescg_pair_liquidation_history(symbol, exchange, interval?, limit?, start_time?, end_time?) - Exchange-specific paircg_liquidation_coin_list(exchange) - All coins on an exchangecg_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 PnLcg_hyperliquid_positions_by_coin() - All positions grouped by coincg_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 metricscg_ohlc_history(symbol, exchange, interval, limit?) - OHLC candlestickscg_taker_volume_history(symbol, exchange, interval, limit?, start_time?, end_time?) - Pair-specific taker volumecg_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 coinscg_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/outflowscg_btc_etf_premium_discount() - ETF price vs NAVcg_btc_etf_history() - Comprehensive history (price, NAV, premium%, shares, assets)cg_btc_etf_list() - List of Bitcoin ETFscg_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 flowscg_eth_etf_list() - Ethereum ETF listcg_eth_etf_premium_discount() - ETH ETF premium/discountcg_sol_etf_flows() - Solana ETF flowscg_sol_etf_list() - Solana ETF listcg_xrp_etf_flows() - XRP ETF flowscg_xrp_etf_list() - XRP ETF listcg_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
cg_liquidation_heatmap("BTC", "Binance") # Cascade levels
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
+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
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 timecg_liquidation_orders reveals recent forced closures- Large liquidation events = cascade risk zones
Flow divergence : Track capital movements:
cg_coin_netflow shows where money is flowingcg_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 : Professional plan allows 6000 requests/minute
- Historical Data Limits :
- Liquidation orders: Past 7 days, max 200 records
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.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
Weekly Installs
3.1K
Repository
starchild-ai-ag…l-skills
GitHub Stars
1
First Seen
13 days ago
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
openclaw3.1K
opencode30
gemini-cli30
github-copilot30
codex30
amp30
