Crypto Futures Derivatives Data Scraper

Coinglass Liquidation Scraper: Crypto Futures Data

Scrape open interest, funding rate, and long/short ratio for linear crypto futures from the official public REST APIs of Binance, Bybit, and OKX, with no exchange login. On the Free plan, derivative-metric-scraped costs $0.008 per record.

• Extract one flat numeric record per metric for spreadsheets, dashboards, or trading scripts.
• Compare open-interest data across Binance, Bybit, and OKX in one run, depending on maxResults.
• Download Bybit funding-rate history and Binance long/short account-ratio data, depending on maxResults.
• Build market-monitoring datasets from public futures endpoints without buyer API keys or cookies.
• Route exchange requests through the prefilled Apify residential proxy.

What you get

Each pushed item is one flat JSON record for one metric, one symbol, and one exchange. Rows contain numeric values and timestamps. A pushed field is not null; when the source does not provide a usable number or timestamp, that metric is not pushed.

Field	Type	What it holds
exchange	string	binance, bybit, or okx
symbol	string	Symbol as requested on Binance and Bybit, such as BTCUSDT; on OKX, the swap ID, such as BTC-USDT-SWAP
metric	string	openInterest, openInterestValue, fundingRate, or longShortRatio
value	number	Parsed numeric value; blank, non-numeric, and NaN source values are not emitted
timestamp	integer	Exchange time in milliseconds; a point without a usable time is not emitted
scrapedAt	ISO 8601 string	ISO 8601 UTC time with milliseconds
platform	string	coinglass-style-aggregator, identifying the metric family

Metrics by exchange

Exchange	Metric names you can receive	Source fields
Binance	openInterest, openInterestValue, longShortRatio	Snapshot openInterest and time; history sumOpenInterest, sumOpenInterestValue, and timestamp; long/short longShortRatio and timestamp
Bybit	openInterest, fundingRate	openInterest with timestamp; fundingRate with fundingRateTimestamp
OKX	openInterest, openInterestValue	oi and oiUsd with ts

Binance does not emit fundingRate. Bybit does not emit openInterestValue or longShortRatio. OKX does not emit fundingRate or longShortRatio. Liquidation orders are not a metric this Actor emits.

Sample output

One record from a successful run:

{
  "exchange": "binance",
  "symbol": "BTCUSDT",
  "metric": "openInterest",
  "value": 92590.494,
  "timestamp": 1793306919326,
  "scrapedAt": "2026-10-29T20:48:47.959Z",
  "platform": "coinglass-style-aggregator"
}

Pricing

Billing is pay-per-event. The listed events are charged as follows:

Plan	Actor start	derivative-metric-scraped
Free	$0.00005 per event	$0.008 per event
Bronze	$0.0000495 per event	$0.00792 per event
Silver	$0.000049 per event	$0.00784 per event
Gold	$0.0000485 per event	$0.00776 per event
Platinum	$0.000048 per event	$0.00768 per event
Diamond	$0.0000475 per event	$0.0076 per event

One normalized record with all fields is charged once as derivative-metric-scraped. A symbol and exchange that produce no parsable rows are not charged for this event.

You pay only for the events listed below. This Actor does not use the Pay per event + usage option, so the platform usage of your runs (compute, proxy traffic and storage) is not billed to you separately.

On the Free plan, 1,000 derivative-metric-scraped events cost $8, and 1,000 Actor start events cost $0.05. On the Free plan, 10,000 derivative-metric-scraped events cost $80, and 10,000 Actor start events cost $0.50. The Apify Free plan includes $5 of monthly platform usage credit; after one Actor start event, the $5 credit covers 624 derivative-metric-scraped records.

How to use

1. Open this Actor in Apify Console with your own Apify account.
2. Enter linear futures symbols such as BTCUSDT, ETHUSDT, or SOLUSDT.
3. Select one or more of binance, bybit, and okx.
4. Set the maximum number of results and keep Apify Proxy enabled.
5. Start the run and open the dataset after it finishes.
6. Repeat the run through Apify Schedules.

{
  "symbols": ["BTCUSDT"],
  "exchanges": ["binance"],
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Export the dataset as JSON or CSV, or read it through the Apify dataset API.

Input parameters

The input schema requires symbols, exchanges, maxResults, and proxyConfiguration. Values are cleaned in the run as described below.

Parameter	What it does	Default
symbols	Linear futures symbols, trimmed and uppercased. Non-strings and empty entries are dropped. If none remain, the default list is used. For OKX, a symbol ending in USDT or USDC becomes BTC-USDT-SWAP; any other suffix is skipped for OKX.	BTCUSDT, ETHUSDT, SOLUSDT
exchanges	Exchanges to query, in listed order. Allowed names are binance, bybit, and okx. Names are lowercased; duplicates and unknown names are dropped. If none remain, all three are used.	binance, bybit, okx
maxResults	Stops once this many records have been charged and pushed. Schema minimum is 1.	200
proxyConfiguration	Proxy for every exchange request. useApifyProxy is turned on if it was off. If no group is set, the group is RESIDENTIAL. If a proxy configuration cannot be created, the run errors before any request because unproxied HTTP is not allowed.	Apify Proxy with group RESIDENTIAL
disableUsageStats	Set to true to turn off the run summary described in Usage statistics.	false

Limits and edge cases

Processing order is exchange, then symbol, after cleaning. The default order is Binance, then Bybit, then OKX, and BTCUSDT before ETHUSDT before SOLUSDT. maxResults is a global cap on pushed records.

Each record is charged and then pushed, so rows already in the dataset stay if a later pair adds nothing. Raise the cap, shorten the symbol list, or query one exchange at a time if you need more of the symbols and exchanges you selected.

Condition	What you see	What to do
Every symbol and exchange returns no rows	The run ends as Failed with status message: no derivative records were returned for the selected symbols and exchanges; no items were charged	Fix symbols or retry later
A request returns a non-200 status or throws	Rows already pushed stay, and the run continues	Run that symbol and exchange again, or drop it from the input
OKX symbol does not end with USDT or USDC	That symbol is skipped for OKX only. Binance and Bybit still use the symbol text you sent	Use a USDT or USDC linear symbol for OKX
maxResults is reached mid-run	Pushing stops. Further rows are not charged	Increase maxResults and run again
Proxy configuration cannot be created	The run errors immediately with the message that unproxied HTTP requests are not allowed	Leave useApifyProxy enabled

FAQ

How much does it cost to scrape crypto futures open interest?

On the Free plan, derivative-metric-scraped is $0.008 per record and Actor start is $0.00005 per event. The $5 Free-plan credit covers 624 derivative-metric-scraped records after one Actor start event. Plan prices are listed in Pricing.

Why did the run fail with no records?

The run fails when nothing was pushed. A symbol OKX cannot convert, a non-200 response, or a body with an error field produces no rows for that call.

Why are some exchanges or symbols missing from the dataset?

Rows already pushed stay, and only those rows are charged as derivative-metric-scraped. Raise maxResults or narrow the input and run again.

Why use this instead of the official Binance, Bybit, and OKX APIs?

It calls those official public endpoints and returns one field schema in an Apify dataset, with no exchange API key. The series each exchange emits are listed in What you get.

Is it legal to collect this public exchange data?

The Actor reads publicly documented Binance, Bybit, and OKX futures endpoints and does not log in. Whether that is allowed for you depends on those sources' terms and on the law that applies to your use case.

Related actors

• CoinGecko Scraper — Crypto Prices, Market Cap & API collects crypto prices and market cap. That is a separate public crypto dataset from these futures open-interest, funding-rate, and long/short records.

Usage statistics

This Actor creates a small, content-free summary at the end of each run, used only to monitor reliability and improve this Actor. No input values, credentials or scraped data are sent.

A copy of the exact record for your run is saved as USAGE_STATS in your own Apify key-value store.

To opt out, set disableUsageStats to true in the input. Nothing is sent then.

Full list of collected fields