CoinGlass Crypto Derivatives Data Scraper

🔗 Scrape crypto derivatives data from CoinGlass — funding rates, open interest, liquidations, long/short ratios, options, and Bitcoin on-chain indices across all major exchanges.

📊 Supported Data Types

Data Type	Description
Funding Rates	Current funding rates across all exchanges for all symbols
Funding Rate History	Historical funding rate OHLC data, weighted by open interest
Funding Rate Arbitrage	Cross-exchange funding rate arbitrage opportunities
Open Interest	Current open interest broken down by exchange
Open Interest History	Historical open interest chart data
Liquidations	Liquidation data by exchange (long/short breakdown)
Long/Short Ratio	Global long/short account ratio history
Taker Buy/Sell Volume	Taker buy vs sell volume ratios by exchange
Options Info	Options market overview (call/put volume, OI, IV)
Bitcoin Bubble Index	Bitcoin market bubble indicator
AHR999 Index	AHR999 Bitcoin valuation index
Puell Multiple	Mining revenue relative to historical average
Stock-to-Flow	Bitcoin stock-to-flow valuation model
Pi Cycle Top	Pi Cycle Top indicator for Bitcoin market tops
Golden Ratio Multiplier	Bitcoin price relative to golden ratio moving averages
Bitcoin Profitable Days	Percentage of days Bitcoin was profitable to hold

🔑 Prerequisites

You need a CoinGlass API key to use this Actor. Get one at CoinGlass Pricing.

🚀 How to Use

1. Get your API key from CoinGlass
2. Select a data type from the dropdown menu
3. Enter a symbol (e.g., BTC, ETH, SOL) — required for most data types
4. Choose time parameters (interval and range) for historical queries
5. Run the Actor and get structured JSON output

📥 Input Parameters

Parameter	Required	Description
api_key	✅	Your CoinGlass Open API key
data_type	✅	Type of data to fetch (see table above)
symbol	For most types	Cryptocurrency symbol (BTC, ETH, SOL, etc.)
interval	For history types	Time interval: 1h, 4h, 8h, 12h, 24h
time_range	For history types	Time range: 1h to 1y
limit	Optional	Max data points (default: 500, max: 5000)

📤 Sample Output

Funding Rates

{
    "data_type": "funding_rates",
    "symbol": "BTC",
    "exchange": "Binance",
    "value": 0.0001,
    "predicted_rate": 0.00012,
    "price": 87500.5,
    "open_interest": 12500000000,
    "fetched_at": "2025-03-21T12:00:00"
}

Open Interest by Exchange

{
    "data_type": "open_interest",
    "symbol": "ETH",
    "exchange": "Binance",
    "value": 5200000000,
    "open_interest": 5200000000,
    "open_interest_change_1h": 0.5,
    "open_interest_change_24h": -2.3,
    "price": 3450.25,
    "fetched_at": "2025-03-21T12:00:00"
}

Bitcoin Bubble Index

{
    "data_type": "bitcoin_bubble_index",
    "symbol": "BTC",
    "exchange": "INDEX",
    "value": 65.3,
    "price": 87500.5,
    "timestamp": "2025-03-21T00:00:00",
    "fetched_at": "2025-03-21T12:00:00"
}

⚡ Notes

• Rate Limits: CoinGlass API has rate limits depending on your subscription tier. The Actor automatically handles 429 responses with a 10-second retry.
• Bitcoin Indices: Data types starting with "bitcoin_" only work for BTC — the symbol parameter is ignored for these.
• Historical Data: For funding_rate_history and open_interest_history, use the interval and time_range parameters to control the granularity and range of historical data.
• Memory: This Actor uses minimal memory (~128MB). Default Apify settings are sufficient.