CoinGlass API brings together real-time and historical data from 30+ leading exchanges worldwide, covering futures, spot, options, ETFs, and on-chain markets. Its unified API reduces the work of integrating multiple exchanges and organizing data. With granularity down to individual raw orders, it provides order books (L2&L3), open interest, funding rates, liquidations, and order flow data to support quantitative research, strategy backtesting, risk monitoring, and application development. It offers the longest historical data coverage in the market. Specific historical coverage and available granularity vary by data type, exchange, and trading pair.
| Item | Details |
|---|---|
| Data coverage | Futures, spot, options, ETF, on-chain, indicators, finance and news |
| Access methods | REST (JSON), WebSocket real-time push, MCP (AI tools) |
| Base URL | https://open-api-v4.coinglass.com |
| Authentication | CG-API-KEY header; the API Key comes with your subscription |
| Endpoints | 168 REST endpoints, 4 WebSocket channels |
| Machine-readable entry points | llms.txt; append .md to the URL of any doc page |
Quickstart
Make your first call in three steps. For the full tutorial (including error handling and more examples), see Quickstart.
- Get an API Key: After you sign up for a CoinGlass account and subscribe to the API, find your API Key in the user center.
- Send a Request: Include your key in the
CG-API-KEYheader. The example below queries all supported futures coins (endpoint docs). - Read the Response: An HTTP status code of 200 with
codeequal to"0"means success, and the result is in thedatafield. For all return codes, see Error Codes and Rate Limits.
curl --request GET \
--url 'https://open-api-v4.coinglass.com/api/futures/supported-coins' \
--header 'CG-API-KEY: YOUR_API_KEY'import requests
url = "https://open-api-v4.coinglass.com/api/futures/supported-coins"
headers = {"CG-API-KEY": "YOUR_API_KEY"}
resp = requests.get(url, headers=headers)
print(resp.json())const res = await fetch(
"https://open-api-v4.coinglass.com/api/futures/supported-coins",
{ headers: { "CG-API-KEY": "YOUR_API_KEY" } }
);
console.log(await res.json());Example response (data truncated):
{
"code": "0",
"data": ["BTC", "ETH", "SOL", "XRP", "BNB"]
}Data Coverage
The 168 REST endpoints are grouped by market into 8 categories, plus 4 real-time WebSocket channels.
| Category | Endpoints | Includes | Docs |
|---|---|---|---|
| Futures | 63 | Trading market, open interest, funding rate, long/short ratio, liquidation, order book, Hyperliquid, taker buy/sell | View |
| Spot | 18 | Trading market, order book, taker buy/sell, footprint and CVD | View |
| Options | 4 | Max pain, options data, exchange open interest and volume history | View |
| On-chain | 7 | Exchange assets and balances, on-chain transfers, token unlocks | View |
| ETF | 17 | Bitcoin, Ethereum, Solana, XRP and HYPE ETF flows, Grayscale fund holdings and premium | View |
| Indicators | 53 | Technical indicators, CGDI and CDRI indexes, cycle and on-chain indicators, macro comparisons | View |
| Finance and News | 5 | Economic data, financial events, central bank activities, news and newsflashes | View |
| Account | 1 | Account plan query | View |
| WebSocket | 4 | Liquidation orders, spot and futures trades, futures ticker snapshots | View |
Common Workflows and Endpoint Combinations
CoinGlass connects cross-exchange open interest, funding rates, liquidations, liquidation models and order flow to help you observe the market structure behind price moves, track flows and test your own hypotheses with historical data.
| Scenario | Your Question | Core Data and Applications |
|---|---|---|
| Market structure | Understand the Market Structure Behind Price Moves | As price changes, what happens to open interest, funding and taker buying/selling? Open interest + funding rates + top trader long/short ratios + CVD Build market structure dashboards to compare positions, funding and trading activity. |
| Key price levels and risk | Monitor Key Price Levels and Market Risk | What do liquidation models, resting orders and actual liquidations show near the current price? Liquidation heatmaps/maps + order books + actual liquidations Build price distribution and risk monitoring dashboards that display models, orders and forced-liquidation events separately. |
| Flows and positions | Track Flows and Large Positions | How are ETF flows changing? What positions are whales opening or closing? ETF flows + Hyperliquid whale alerts and positions Build flow dashboards and research reports to track fund net inflows and large position changes. |
| Research and integration | Test Strategies and Integrate Data into Your Systems | How have these indicators behaved historically, and how can they support ongoing research and monitoring? Cross-market historical data + REST queries + WebSocket streams Build backtest datasets and continuously updated data services for your own research or trading systems. |
See recommended endpoints, combination steps and data definitions for each workflow.
Use CoinGlass Data in AI Tools
Both the docs and the data can be read and called directly by AI agents.
API Plans and Permissions
API plans primarily differ in available data, historical range, request limits and usage rights. Higher plans include the public endpoints available on lower plans.
| API Plan | Core Capabilities | Finest Candle Interval | Requests / Minute | Usage Scope |
|---|---|---|---|---|
| Hobbyist | Basic market data, open interest, funding rates, long/short ratios and ETFs | 4 hours | 30 | Personal |
| Startup | Adds CVD, flows, Hyperliquid whale alerts and wallet positions | 30 minutes | 80 | Personal |
| Standard | Adds WebSocket, liquidation orders, order book heatmaps and large orders | 1 minute | 300 | Commercial |
| Professional | Adds liquidation heatmaps/maps, footprint charts and position analysis by tag; longer minute-level history | 1 minute | 1,200 | Commercial |
| Enterprise | Custom rates, data granularity, historical ranges and CSV/bulk delivery | As agreed | Custom | Commercial |
“Finest candle interval” describes interval permissions on applicable historical endpoints. It is not the data update frequency or the granularity of raw order data. Daily ETF data, real-time lists and other datasets follow their endpoint descriptions.
View pricing, full permissions and historical ranges · Check minimum plans by endpoint · Explore Enterprise Customization
Next Steps
- Authentication
Header format and key management - Error Codes and Rate Limits
Return codes and the rate limiting rules for each API plan - Endpoint Overview
A list of all REST endpoints - Changelog
Records of new endpoints and field changes
Popular Crypto Data Endpoints
The 8 types of data developers use most:
- Bitcoin Open Interest API
Open interest OHLC candles for the whole market and for individual exchanges - Funding Rate API
Perpetual futures funding rates and their history on each exchange - Liquidation Data API
Liquidation history, liquidation orders and real-time push - Liquidation Heatmap API
Multi-model liquidation heatmaps and liquidation maps - Long/Short Ratio API
Account long/short ratio and top trader position long/short ratio - Bitcoin ETF Flows API
Spot ETF net inflows, net assets and premium - Hyperliquid Whale Data API
Whale positions and wallet PnL distribution - Fear & Greed Index API
Crypto market sentiment index history
About CoinGlass API
What Is CoinGlass API?
CoinGlass API V4 is a professional-grade crypto market data and analytics API that provides unified access to real-time and historical data across derivatives, options, spot, ETF and on-chain markets from major global cryptocurrency exchanges. As the next-generation evolution of the CoinGlass data platform, API V4 adopts a more structured, scalable and analytics-focused API architecture.
CoinGlass was originally known for its industry-leading crypto derivatives data and has long and consistently provided highly structured core metrics, including open interest, funding rates, liquidation events, liquidation heatmaps, liquidation maps, long/short ratios and derivatives flows. With the launch of API V4, CoinGlass has significantly expanded its data capabilities on this foundation to cover deeper market structure and analytics data, including spot order books, L2 and L3 order flow data, whale and large-position activity, ETF net inflows, on-chain reserves and macro crypto market indicators.
Key Highlights of CoinGlass API V4
- Aggregates data from 30+ leading exchanges worldwide, including Binance, OKX, Bybit, and Coinbase, covering derivatives and spot markets.
- Supports 250,000+ instruments across futures, spot, and options markets.
- Fine-grained real-time and historical data access, including funding rates, open interest, price OHLC, liquidations, long/short ratios, whale metrics and market structure data
- Advanced order book and order flow analytics, with L2 and L3 order book depth, liquidity distribution and large order tracking
- Expanded macro and on-chain datasets, covering ETF flows, on-chain reserves, ERC20 transfers, and macro indicators such as the Crypto Fear & Greed Index, Stock-to-Flow and the Rainbow Chart
- Developer-friendly RESTful API design with a unified response structure, pagination and filtering, built for scalable, production-grade applications
What Crypto Market Data Is Available?
For futures markets, you can get open interest, funding rates, long/short ratios, liquidation orders, liquidation heatmaps, order book depth, taker buy/sell volume and footprint charts; for spot markets, you can get trading pair market data, order books, taker buy/sell and inflows/outflows; options, ETF and on-chain data cover options max pain, flows of spot ETFs such as Bitcoin and Ethereum ETFs, exchange asset reserves and large on-chain transfers. Indicator endpoints provide technical indicators such as RSI and MACD, the CGDI and CDRI indexes, and cycle indicators such as Ahr999, the Rainbow Chart and the Fear & Greed Index.
Who Uses CoinGlass API?
CoinGlass API supports personal market monitoring, professional trading analysis, quantitative research, institutional research and data product development. Choose core data and endpoint combinations by workflow, then select a plan based on the endpoints, intervals and usage rights you need.
FAQ
How do I get a CoinGlass API Key?
After you sign up for a CoinGlass account and subscribe to an API plan, find your API Key in the user center. When calling an endpoint, include the key in the CG-API-KEY header.
Which exchanges does CoinGlass API support?
It covers major exchanges such as Binance, OKX, Bybit and Coinbase. You can query the full list in real time with the Supported Exchanges endpoint.
What are the differences between API plans?
The API plan determines which endpoints are available, the number of requests per minute and the historical data depth. For a full comparison of the API plans, see API Plans and Permissions; for prices, see the pricing page.
Can the data be used in commercial products?
Yes. Commercial use requires an API plan of Standard and above, subject to the Terms of Service.
Is there a free version of CoinGlass API?
The API Key comes with a subscription, and Hobbyist is the lowest subscription plan. See API Plans and Permissions for monthly and annual prices.
Which programming languages can I use to call CoinGlass API?
Any language that can send HTTPS requests will work, e.g., Python, JavaScript, Go, Java, PHP and C#. The docs provide cURL, Python and JavaScript examples, and you can also query data directly in AI tools through CoinGlass MCP (Beta).
Need more data?Custom rate limits, longer historical data, CSV and bulk export, and similar needs are available through Enterprise Customization.