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 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)
```
- Liquidation heatmap analysis
```
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
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

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: Professional plan allows 6000 requests/minute
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

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

coinglass

NPX Install

Tags

SKILL.md Content

Coinglass

When to Use Coinglass

Tool Categories

1. Basic Derivatives Analytics (7 tools)

2. Advanced Long/Short Ratios (6 tools)

3. Advanced Liquidations (4 tools)

4. Hyperliquid Whale Tracking (4 tools)

5. Futures Market Data (5 tools)

6. Volume & Flow Analysis (4 tools)

7. Bitcoin ETF Data (5 tools)

8. Other ETF Data (8 tools)

Common Workflows

Quick Market Scan

Deep Position Analysis

ETF Flow Monitoring

Whale Tracking

Volume Analysis

Interpretation Guides

Funding Rates

Open Interest + Price Matrix

Long/Short Ratio

CVD (Cumulative Volume Delta)

ETF Flows

Analysis Patterns

Performance Optimization

Batch vs Individual Calls

Query Parameters

Supported Exchanges

Important Notes

Data Quality Notes

Version History