Tags:
cryptocurrencyapiquantitative-financereviewpythonEstimated reading time: 22 minutes | Updated: May 2026
The Honest Answer Up Front
Yes — if you trade derivatives.
No — if you only need spot prices.
That's the short version. The long version is more nuanced, and it matters for your decision. I've spent time integrating CoinGlass API V4 into production systems, tested every major endpoint, and compared it against the alternatives. This review covers everything: what the data actually looks like, which plan fits which use case, where it falls short, and who should absolutely be using it.
Let's get into it.
What Is CoinGlass API?
CoinGlass started as a derivatives data dashboard — a place where traders could monitor funding rates, open interest, and liquidations across multiple exchanges in one place. It became one of the most-bookmarked tools in the crypto quant community because it solved a real problem: aggregating derivatives data across 30+ exchanges is genuinely hard, and CoinGlass did it well.
The API is the programmatic version of that dashboard. Instead of clicking around a website, you query structured endpoints and get clean JSON back. As of 2026, it's running on V4 — a complete rewrite of the old API with a new base URL, new authentication header, and significantly expanded endpoint coverage.
⚠️ Migration note: If you're using any version before V4, those endpoints are deprecated and no longer supported. The new base URL is
https://open-api-v4.coinglass.com. The auth header changed fromcoinglassSecrettoCG-API-KEY.
Who Is This For?
Before diving into features and pricing, let's be clear about the target audience:
┌─────────────────────────────────────────────────────────────┐
│ Who Should Use CoinGlass API │
├──────────────────────────────┬──────────────────────────────┤
│ Great Fit │ Not the Right Tool │
├──────────────────────────────┼──────────────────────────────┤
│ Quant traders building │ Projects that only need │
│ derivatives strategies │ spot price feeds │
│ │ │
│ Risk management systems │ Portfolio trackers that │
│ monitoring liquidation risk │ don't use derivatives │
│ │ │
│ Funding rate arbitrage bots │ NFT or DeFi projects with │
│ │ no perpetual exposure │
│ Market structure researchers │ │
│ studying OI and sentiment │ Casual traders who don't │
│ │ need programmatic access │
│ Institutional desks that │ │
│ need cross-exchange data │ Projects where CoinGecko │
│ │ free tier already works │
│ Alert systems monitoring │ │
│ 24/7 market conditions │ │
└──────────────────────────────┴──────────────────────────────┘
If you're in the left column, keep reading. If you're in the right column, CoinGecko or CoinMarketCap will serve you better at lower cost.
Data Coverage: What You Actually Get
This is where CoinGlass genuinely stands apart from every other crypto data provider. The depth of derivatives coverage is unmatched.
Derivatives Data (The Core Value Proposition)
Derivatives Module — Endpoint Overview
═══════════════════════════════════════════════════════════════
Category Endpoints Update Freq
───────────────── ──────────────────────────── ───────────
Open Interest /ohlc-history ≤ 1 min
/aggregated-history
/exchange-list
Funding Rate /ohlc-history ≤ 1 min
/oi-weight-ohlc-history
/exchange-list
Liquidations /history ≤ 1 min
/aggregated-history
/heatmap/model2
Long/Short Ratios /global-long-short-account- ≤ 1 min
ratio/history
/top-long-short-account-
ratio/history
/taker-buy-sell-volume/history
═══════════════════════════════════════════════════════════════
Exchange coverage for futures data: Binance, OKX, Bybit, CME, Bitget, Deribit, Bitmex, Bitfinex, Gate, Kraken, KuCoin, dYdX, CoinEx, BingX, Coinbase, Crypto.com, Hyperliquid, and more — 30+ exchanges in total.
The liquidation heatmap endpoint (/api/futures/liquidation/heatmap/model2) deserves special mention. This is genuinely unique data — a model that estimates where liquidation clusters are building across price levels, based on current open positions. I haven't found a comparable endpoint at any other data provider.
Beyond Derivatives
CoinGlass V4 also covers:
Spot Market
-
/api/spot/coins-markets— Spot asset market data -
/api/spot/orderbook/history— Order book heatmap history -
/api/spot/large-limit-order-history— Historical large limit orders -
/api/spot/taker-buy-sell-volume/history— Taker buy/sell volume
Options Market
-
/api/option/info— Options chain data -
/api/option/exchange-oi-history— Options OI history -
/api/option/exchange-vol-history— Options volume history
ETF Data (genuinely exclusive)
-
/api/bitcoin/etf/flow-history— BTC ETF daily inflow/outflow -
/api/ethereum/etf/flow-history— ETH ETF fund flows - Also covers Solana, XRP ETF data
This ETF flow data is something I haven't seen systematically available anywhere else. For macro-oriented quant strategies that incorporate institutional capital flows, this is a significant data edge.
On-Chain Data
-
/api/exchange/balance/list— Exchange reserve balances -
/api/exchange/chain/tx/list— On-chain transfer records (ERC-20)
Market Indicators (100+)
- RSI, MACD, Bollinger Bands, MA
- Fear & Greed Index
- Coinbase Premium Index
- Bitcoin Rainbow Chart
- CGDI, CDRI (proprietary whale/depth indicators)
Pricing Breakdown
Here's the complete pricing structure as of May 2026:
┌──────────────────────────────────────────────────────────────────────────┐
│ CoinGlass API Pricing (2026) │
├──────────────┬──────────┬───────────┬──────────┬─────────────┬──────────┤
│ │HOBBYIST │ STARTUP │ STANDARD │PROFESSIONAL │ENTERPRISE│
├──────────────┼──────────┼───────────┼──────────┼─────────────┼──────────┤
│ Monthly │ $29 │ $79 │ $299 │ $699 │ Custom │
│ Annual │ $348 │ $948 │ $3,588 │ $8,388 │ Custom │
│ Annual saving│ $72 │ $192 │ $960 │ $2,160 │ — │
├──────────────┼──────────┼───────────┼──────────┼─────────────┼──────────┤
│ Endpoints │ 80+ │ 130+ │ 150+ │ 160+ │ Custom │
│ Rate limit │ 30/min │ 80/min │ 300/min │ 1200/min │ Custom │
│ Update freq │ ≤1 min │ ≤1 min │ ≤1 min │ ≤1 min │ ≤1 min │
│ Commercial │ ✗ │ ✗ │ ✓ │ ✓ │ ✓ │
│ Support │ Email │ Email │ Email │ Chat │Dedicated │
└──────────────┴──────────┴───────────┴──────────┴─────────────┴──────────┘
Historical Data Range by Plan
This table matters a lot for backtesting — and it's one of the most important things to check before choosing a plan:
┌──────────────┬──────────┬───────────┬──────────┬─────────────┐
│ Interval │HOBBYIST │ STARTUP │ STANDARD │PROFESSIONAL │
├──────────────┼──────────┼───────────┼──────────┼─────────────┤
│ 1 min │ — │ — │ 6 days │ 12 days │
│ 5 min │ — │ — │ 30 days │ 60 days │
│ 15 min │ — │ — │ 90 days │ 180 days │
│ 30 min │ — │ 90 days │ 180 days │ 360 days │
│ 1 hour │ — │ 180 days │ 360 days │ 720 days │
│ 4 hour │ 180 days │ 180 days │ 360 days │ 720 days │
│ 8 hour │ 360 days │ 360 days │ 360 days │ 720 days │
│ 1 day │ All-time │ All-time │ All-time │ All-time │
└──────────────┴──────────┴───────────┴──────────┴─────────────┘
Key insight: If you need hourly-granularity backtesting, the Hobbyist plan won't work — it doesn't provide 1-hour historical data. Startup ($79/month) gives you 180 days of hourly data, which is sufficient for most strategy development. Standard ($299/month) gives you a full year of hourly data, which is the sweet spot for serious backtesting.
Which Plan for Which Use Case?
Decision Guide: Choosing Your Plan
────────────────────────────────────────────────────────────────
HOBBYIST ($29/mo) — Right for you if:
✓ Building and testing a monitoring system
✓ Only need real-time data, not deep history
✓ Personal / non-commercial project
✓ Calling ≤ 30 endpoints per minute
✗ Don't choose if you need sub-4h historical granularity
STARTUP ($79/mo) — Right for you if:
✓ Active strategy development requiring hourly history
✓ Running a monitor across 5–10 symbols
✓ Need 130+ endpoints including advanced data types
✓ Backtesting with up to 180 days hourly data
✗ Don't choose if you need sub-30min granularity
STANDARD ($299/mo) — Right for you if:
✓ Commercial product or service built on the data
✓ Need full year of hourly historical data for backtesting
✓ Higher throughput (300 req/min) for multi-asset systems
✓ Professional quant team with multiple users
✗ Don't choose if budget is constrained — Startup is often enough
PROFESSIONAL ($699/mo) — Right for you if:
✓ Institutional desk or fund-level usage
✓ Need 5-minute granularity for high-frequency strategies
✓ High-volume data pipelines (1200 req/min)
✓ Need 2 years of hourly historical data
✗ Very few individual traders need this tier
────────────────────────────────────────────────────────────────
Developer Experience
Authentication
Dead simple. Add one header to every request:
headers = {
"CG-API-KEY": "your_api_key_here",
"Accept": "application/json"
}
That's it. No OAuth, no token refresh, no signature calculation. For a data API, this is exactly what you want.
Response Format
All endpoints return consistent JSON:
{
"code": "0",
"msg": "success",
"data": [ ... ]
}
The data field always contains an array, even for single-item responses. This consistency makes it easy to write a generic request wrapper.
A Minimal Working Example
import requests
BASE_URL = "https://open-api-v4.coinglass.com"
API_KEY = "your_api_key"
headers = {
"CG-API-KEY": API_KEY,
"Accept": "application/json"
}
# Fetch BTC funding rates across all exchanges
resp = requests.get(
f"{BASE_URL}/api/futures/fundingRate/exchange-list",
headers=headers,
params={"symbol": "BTC"},
timeout=10
)
data = resp.json()["data"]
for exchange in data[:5]:
rate_pct = float(exchange["fundingRate"]) * 100
print(f"{exchange['exchangeName']:12s} {rate_pct:+.4f}%")
Output:
Binance +0.0312%
OKX +0.0289%
Bybit +0.0334%
Bitget +0.0301%
Deribit +0.0178%
Rate Limiting
Rate limits are per-minute, per-API-key. The API returns standard HTTP 429 when you hit the limit. In practice, for a monitor polling every 5 minutes across 2–3 symbols with 5–6 endpoints each, even the Hobbyist plan's 30 req/min is more than sufficient.
For larger systems calling many endpoints in parallel, add a small delay between requests:
import time
def safe_get(endpoint, params):
resp = requests.get(endpoint, headers=headers, params=params, timeout=10)
time.sleep(0.3) # 300ms between calls stays well under any rate limit
return resp.json().get("data", [])
WebSocket Support
CoinGlass V4 includes WebSocket for real-time data streams:
const ws = new WebSocket("wss://open-api-v4.coinglass.com/ws");
ws.onopen = () => {
ws.send(JSON.stringify({
op: "subscribe",
args: ["liquidationOrders"] // Real-time liquidation event stream
}));
};
ws.onmessage = (event) => {
const data = JSON.parse(event.data);
console.log(data);
};
Current WebSocket streams include liquidation orders and futures trade executions. For building real-time alert systems, this is significantly more efficient than polling REST endpoints every few seconds.
Documentation Quality
The V4 documentation at docs.coinglass.com covers all endpoints with parameter tables and response field descriptions. It's functional and accurate. It won't win design awards, but everything you need is there. The main improvement I'd suggest: more worked examples showing how to combine multiple endpoints for real use cases. Currently the docs treat each endpoint in isolation.
Data Quality Assessment
I compared CoinGlass data against exchange-native APIs for several metrics. Here's what I found:
Funding Rates
Funding rate values matched exchange-native data within rounding precision. The aggregated average across exchanges is computed server-side and delivered cleanly — saves you from having to poll each exchange individually and compute the aggregate yourself.
Open Interest
OI data is sourced and aggregated in near real-time. Cross-referencing against Binance's own /fapi/v1/openInterest endpoint showed consistent values with latency under 60 seconds in normal market conditions. During high-volatility periods, there can be brief discrepancies as the aggregation pipeline processes updates — expected behavior.
Liquidation Data
This is where CoinGlass genuinely shines. Cross-exchange liquidation aggregation is difficult to replicate independently — you'd need separate WebSocket connections to 30+ exchanges and significant infrastructure to aggregate them. CoinGlass handles all of that and delivers clean, structured historical data.
The liquidation heatmap model is particularly valuable. It's not raw exchange data — it's a derived model estimating where liquidation pressure is building based on inferred position entry prices. This kind of processed data would take significant engineering effort to replicate internally.
Long/Short Ratios
Two distinct endpoints — global (all accounts) and top traders — provide meaningfully different perspectives. The top trader ratio, in particular, is data that individual traders simply cannot obtain from exchange public APIs alone.
What's Missing
No honest review skips the weaknesses. Here's where CoinGlass V4 falls short:
1. No free tier
The Hobbyist plan at $29/month is the entry point. There's no free API access for testing, which makes it harder to evaluate before committing. You can use the CoinGlass website to preview the data visually, but you can't make API calls without paying.
2. Spot price coverage is secondary
If you need comprehensive spot price data across thousands of tokens, CoinGecko or CoinMarketCap are better choices. CoinGlass covers spot markets (/api/spot/coins-markets, /api/spot/pairs-markets) but this isn't their strength. Derivatives first, spot second.
3. Historical granularity gating
Sub-hourly historical data is locked to Standard ($299/month) and above. If you're building a strategy that needs 15-minute or 5-minute historical data for backtesting, the Startup plan won't cut it and you're jumping to $299/month. For some teams this is a meaningful constraint.
4. No on-chain DeFi coverage
For DeFi-native strategies requiring protocol TVL, liquidity pool data, or DEX volume, you'll need to supplement with The Graph or DeFiLlama's API. CoinGlass is CEX-native.
5. Commercial use requires Standard tier
At $299/month. For teams building commercial products on top of the data, this is the realistic entry point. Hobbyist and Startup are personal-use only per the terms.
How It Compares
CoinGlass vs. Key Alternatives
═══════════════════════════════════════════════════════════════════════
CoinGlass CoinGecko CoinMarketCap Glassnode
───────────── ────────── ───────── ───────────── ─────────
Focus Derivatives Spot+DeFi Spot+Market On-chain
specialist generalist generalist specialist
Funding Rate ★★★★★ ★★☆☆☆ ★★☆☆☆ ★☆☆☆☆
Coverage
Open Interest ★★★★★ ★★☆☆☆ ★★☆☆☆ ★★☆☆☆
Coverage
Liquidation ★★★★★ ★☆☆☆☆ ★☆☆☆☆ ★☆☆☆☆
Data
L/S Ratio ★★★★★ ★☆☆☆☆ ★☆☆☆☆ ★★☆☆☆
(Multi-source)
Spot Prices ★★☆☆☆ ★★★★★ ★★★★★ ★★☆☆☆
On-chain ★★☆☆☆ ★★☆☆☆ ★☆☆☆☆ ★★★★★
Analytics
ETF Flows ★★★★★ ★★☆☆☆ ★★☆☆☆ ★★☆☆☆
Entry Price $29/mo Free tier Free tier $29/mo
(no free) available available
Exchange 30+ From From BTC/ETH
Coverage exchanges exchange exchange focused
APIs APIs
═══════════════════════════════════════════════════════════════════════
The practical takeaway: for derivatives data, CoinGlass has no real competitor at this price point. For everything else, it's one tool among several.
The ideal setup for most quant teams: CoinGlass for derivatives + CoinGecko for spot prices + Glassnode for on-chain macro. Each does one thing exceptionally well.
Real-World Use Cases
Here are the use cases where teams are getting the most value from CoinGlass API V4:
1. Funding Rate Arbitrage
The classic carry trade: simultaneously long on the spot market and short on the perpetual futures of the same asset, collecting the positive funding rate. This only makes money when funding rates are positive and high enough to cover execution costs.
CoinGlass's /api/futures/fundingRate/exchange-list gives you cross-exchange rates in one call. You can identify which exchange offers the highest rate at any given moment, automating the optimal venue selection for your short leg.
2. Liquidation Cascade Prediction
A monitoring system that watches /api/futures/liquidation/history for single-hour liquidation events exceeding a threshold. When liquidations spike beyond normal levels and are concentrated on one side, it signals a cascade is either underway or beginning — historically correlating with accelerated price moves in the same direction.
3. Market Regime Detection
Using OI change, funding rate, and long/short ratio together to classify the current market regime:
Regime Classification Using Three Signals
──────────────────────────────────────────────────────────
OI Change Funding Rate L/S Ratio Regime
────────── ──────────── ───────── ──────────────
+High +High >60% L Euphoria / Top Risk
+High -High >55% S Capitulation building
-High Near zero ~50/50 Deleveraging
Stable +Moderate ~50/50 Healthy uptrend
Stable -Moderate ~50/50 Healthy downtrend
──────────────────────────────────────────────────────────
4. Smart Money Sentiment Tracker
Comparing global-long-short-account-ratio against top-long-short-account-ratio in real time. When the gap between retail and top-trader positioning exceeds 10 percentage points and they're on opposite sides, it has historically been one of the more reliable contrarian signals available from public data.
5. ETF Flow Correlation Studies
The /api/bitcoin/etf/flow-history endpoint is unique in the market. Research teams use it to study the correlation between institutional ETF flows and BTC price, building models that incorporate macro capital flow signals alongside pure technical derivatives data.
Verdict: Who Should Buy, Who Should Skip
Final Recommendation Matrix
╔═══════════════════════════════════════════════════════════════╗
║ Profile Recommendation ║
╠═══════════════════════════════════════════════════════════════╣
║ Quant trader building ✅ Buy — Hobbyist or ║
║ derivatives strategies Startup depending on ║
║ history depth needed ║
╠═══════════════════════════════════════════════════════════════╣
║ Risk manager monitoring ✅ Buy — Startup gives ║
║ leveraged positions 24/7 you everything needed ║
╠═══════════════════════════════════════════════════════════════╣
║ Funding rate arbitrage team ✅ Buy — ROI is clear ║
║ if the strategy works ║
╠═══════════════════════════════════════════════════════════════╣
║ Market structure researcher ✅ Buy — Unique data ║
║ not available elsewhere ║
╠═══════════════════════════════════════════════════════════════╣
║ Spot-only trader / investor ⏭️ Skip — CoinGecko ║
║ free tier is enough ║
╠═══════════════════════════════════════════════════════════════╣
║ DeFi protocol developer ⏭️ Skip — Wrong tool ║
║ for your use case ║
╠═══════════════════════════════════════════════════════════════╣
║ Commercial product builder ✅ Buy Standard ($299) ║
║ — commercial use requires ║
║ this tier ║
╠═══════════════════════════════════════════════════════════════╣
║ Institutional fund ✅ Buy Professional or ║
║ Enterprise — contact ║
║ sales for custom terms ║
╚═══════════════════════════════════════════════════════════════╝
The Bottom Line
CoinGlass API V4 is the best-in-class source for crypto derivatives data. Funding rates, open interest, liquidations, long/short ratios — all aggregated across 30+ exchanges, updated in under a minute, available through clean and consistent REST and WebSocket endpoints.
The pricing is fair for what you get. $29/month (Hobbyist) is a legitimate entry point for personal projects. $79/month (Startup) is the right tier for active strategy development. $299/month (Standard) is the threshold for commercial use and deeper historical data.
The main caveats — no free tier, secondary spot coverage, commercial terms requiring Standard — are real but clearly communicated. If your work touches derivatives markets and you need programmatic access to cross-exchange data, this is the tool.
Quick Start Checklist
Before you sign up, confirm:
- [ ] Your use case involves perpetual futures or derivatives data
- [ ] You need data from more than one exchange
- [ ] You have basic Python or JavaScript skills to integrate the API
- [ ] You've reviewed which historical data depth your strategy requires
- [ ] You've checked whether your use is personal or commercial (affects plan choice)
If all five boxes are checked, you're ready to get started.
Frequently Asked Questions
Q: Is there a free trial?
There's no free API tier, but the CoinGlass website gives you visual access to the same data before committing. You can also reach out to their team at contact@coinglass.com to discuss trial access for specific evaluation scenarios.
Q: Can I use the Hobbyist plan for a commercial product?
No. Commercial use requires the Standard plan ($299/month) per the terms of service.
Q: How reliable is the API uptime?
In production use, the API has been consistently available during high-volatility periods — exactly when you need it most. That said, always build retry logic and error handling into any production system.
Q: Does CoinGlass offer annual discounts?
Yes. Annual billing saves between $72/year (Hobbyist) and $2,160/year (Professional) compared to monthly billing.
Q: What programming languages are supported?
The API is REST + WebSocket, so any language works. The examples in the official documentation are in Python and JavaScript. The community has also built unofficial client libraries, including a Python package (coinglass-api on PyPI) that wraps the endpoints with pandas DataFrame output.
Resources
🔑 Pricing & Sign Up: coinglass.com/pricing
📘 API V4 Documentation: docs.coinglass.com
📊 Data Preview (no account needed): coinglass.com
This review reflects the CoinGlass API V4 as of May 2026. Pricing and features may have changed — verify at coinglass.com/pricing before purchasing.
Not financial advice. All trading involves risk.
Top comments (0)