# Crypto Derivatives Data: Open Interest, Funding & Liquidations (`feeddlabs/crypto-derivatives-data`) Actor

Query available crypto open interest, funding, liquidation, and flow data by exchange and interval. Free demo: fixed sample only; paid Apify plan required for custom data. API platform usage is billed separately by Apify.

- **URL**: https://apify.com/feeddlabs/crypto-derivatives-data.md
- **Developed by:** [Feedd Labs](https://apify.com/feeddlabs) (community)
- **Categories:** AI
- **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 rows

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Crypto Derivatives Data: Open Interest, Funding & Liquidations

**Free demo:** runs and API requests return a fixed sample of real rows.
Your accounts, queries, dates, and filters are not applied. Repeating a run
returns the same sample; a smaller row limit returns its prefix. Upgrade
your Apify plan to request your own data. Demo rows have no result charge;
the listed Actor start charge still applies.

Open interest, funding rates, liquidations, long/short ratio, basis, CVD, and
taker flow for supported perpetual markets on Binance, Bybit, OKX, and
Hyperliquid, per exchange or combined. Historical availability varies by
exchange, symbol, and metric.

**$1 per 1,000 rows.** No exchange API key required. Try the fixed Free demo.

### Why use it

- **History.** Query available open interest, funding, and liquidation
  series, with intervals down to 1 minute. Coverage differs by series.
- **Joined metrics.** Price, open interest, funding, long and short
  liquidations, long/short ratio, mark and index price, basis, CVD, and taker
  buy ratio, side by side per time bucket.
- **Per exchange or combined.** Binance, Bybit, OKX, and Hyperliquid
  separately, or combined into one market-wide series.
- **Individual liquidations and whale trades.** Each liquidation with side,
  price, and size for the last 10 days, and the largest trades for the last
  month.

### Quick start

```json
{ "symbols": ["BTC", "ETH", "SOL"], "interval": "1h", "from": "2026-09-01" }
```

Per exchange, daily, back to 2020:

```json
{ "symbols": ["BTC"], "exchanges": ["binance", "bybit", "okx", "hyperliquid"], "interval": "1d", "from": "2020-01-01" }
```

Available liquidation events from the recent retention window:

```json
{ "symbols": ["ETH"], "data": "liquidations" }
```

### What you get

| Field | What it is |
| --- | --- |
| `symbol`, `exchange`, `market` | Coin, exchange (or `all`) and contract |
| `time`, `timestamp` | Start of the time bucket |
| `price` | Close price |
| `open_interest`, `open_interest_usd` | Open interest in coins and in USD |
| `funding_rate` | Funding rate (0.0001 = 0.01%) |
| `liquidations_long_usd`, `liquidations_short_usd` | Longs and shorts liquidated (USD) |
| `long_short_ratio` | Accounts long ÷ short |
| `mark_price`, `index_price`, `basis` | Futures premium over spot |
| `cvd`, `taker_buy_ratio` | Buy minus sell volume, and the buying share |

#### Example

```json
{
  "type": "metrics",
  "symbol": "BTC",
  "exchange": "binance",
  "market": "BTCUSDT",
  "interval": "1h",
  "time": "2026-10-10T00:00:00.000Z",
  "price": 82529.7,
  "open_interest": 92719.763,
  "open_interest_usd": 7652134224.46,
  "funding_rate": 0.00003484,
  "liquidations_long_usd": 11806.45,
  "liquidations_short_usd": 578.06,
  "long_short_ratio": 1.4789,
  "mark_price": 82534.7,
  "index_price": 82569.75,
  "basis": -35.05,
  "cvd": 15.869,
  "taker_buy_ratio": 0.5033
}
```

Download as CSV, Excel, or JSON.

### Use it as an API

Call it like a REST API, with no runs to manage: `/metrics`, `/liquidations`,
and `/whale-trades` answer in JSON with the same rows and prices as a run. Try
them in the **Endpoints** tab, or copy the Actor's URL from there:

```bash
curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  "https://ACTOR_URL/metrics?symbol=BTC&exchange=all&interval=1h"
```

### Pricing

Prices below are result fees. The **Pricing** tab also lists an Actor start
charge, including for empty runs, demo runs, and problem reports. Demo rows have
no result charge. Custom data requires a paid Apify plan. Its subscription
includes usage credit; it is not a separate Feedd subscription. API calls
require an Apify token.

$1 per 1,000 rows, whatever the metrics: 7,000 returned rows cost $7 in
result fees. On Apify's Business plan, $0.80 per 1,000. Paid plans return
available closed intervals; collection delays can vary. A run stops at
10,000 rows unless you raise **Maximum rows**.

Apify Free plan: fixed sample data only. Runs and API calls return the same
sample. Upgrade for custom data at the result rates above.

### FAQ

**Which coins?** Supported perpetual markets include BTC, ETH, and SOL.
Availability varies by exchange and listing date.

**How far back?** Open interest, funding, and liquidations to 2020 on Binance,
Bybit, and OKX, and to December 2024 on Hyperliquid. Individual liquidations
cover the last 10 days, whale trades the last month.

**How fresh is it?** Paid plans return available closed intervals. Source
and collection delays vary. Free-plan requests return a fixed historical sample.

**Can AI agents use it?** Yes. Add
`https://mcp.apify.com?tools=feeddlabs/crypto-derivatives-data` to Claude,
ChatGPT, or Cursor and ask, for example, "Where is BTC funding highest right
now?"

**Something not right?** Write it in **Report a problem** and run the Actor.
The run only submits your report, with no result charge. The listed Actor
start charge still applies. AI agents can report problems too.

### More from Feedd Labs

| Actor | What it does |
| --- | --- |
| [X (Twitter) Real-Time Monitor](https://apify.com/feeddlabs/x-twitter-user-tracker) | Posts and account changes delivered by WebSocket or webhook |
| [X (Twitter) Search Scraper](https://apify.com/feeddlabs/x-twitter-search) | Tweets and replies by keyword, account and date |
| [X (Twitter) Followers Scraper](https://apify.com/feeddlabs/x-twitter-followers-scraper) | Followers, following and profiles of public accounts |
| [X (Twitter) Account Watch](https://apify.com/feeddlabs/x-account-changes) | Who an account follows or unfollows, and its profile changes |
| [X (Twitter) Ads Library](https://apify.com/feeddlabs/x-ads-library) | Collected promoted ads and brand creative |
| [Mainstream News Live & Archive](https://apify.com/feeddlabs/mainstream-news-archive) | Collected news articles from major outlets |
| [US Stock Market Data](https://apify.com/feeddlabs/us-stock-market-data) | 1-minute stock history since 2016, futures and financial statements |
| [Crypto Derivatives Data](https://apify.com/feeddlabs/crypto-derivatives-data) | Open interest, funding and liquidations on 4 exchanges |
| [Crypto OHLCV & Trades](https://apify.com/feeddlabs/crypto-ohlcv-trades-data) | Candles from 1 second to 1 day and individual trades |
| [Polymarket Data](https://apify.com/feeddlabs/polymarket-odds-history) | Available odds history, volume and open interest by event |

# Actor input Schema

## `symbols` (type: `array`):

Coins such as BTC, ETH, SOL, PEPE or HYPE (BTCUSDT works too). Up to 50 per run.

## `data` (type: `string`):

Metrics: one row per coin, exchange and time bucket. Liquidations and whale trades: one row per event.

## `exchanges` (type: `array`):

Pick one or more. "All exchanges combined" sums open interest and liquidations, and averages funding across exchanges. Default: all exchanges combined.

## `metrics` (type: `array`):

Metrics mode: the columns to fill. Default: all.

## `interval` (type: `string`):

Metrics mode: one row per interval.

## `from` (type: `string`):

First day (YYYY-MM-DD). Default: 30 days for hourly rows, 7 days for events. History goes back to 2020.

## `to` (type: `string`):

Last day, included (YYYY-MM-DD). Default: now.

## `minUsd` (type: `integer`):

Whale trades mode: only trades at least this big. Default: the largest 1% of trades.

## `maxItems` (type: `integer`):

Stop after this many rows in total. Total across the whole run, not per query or account. On Free, this can only shorten the fixed sample.

## `reportProblem` (type: `string`):

Something wrong or missing? Write it here and run: we get your message, the run does nothing else, and it's free. AI agents can use this too.

## Actor input object example

```json
{
  "symbols": [
    "BTC",
    "ETH"
  ],
  "data": "metrics",
  "exchanges": [
    "all"
  ],
  "interval": "1h",
  "maxItems": 10000
}
```

# Actor output Schema

## `rows` (type: `string`):

Dataset rows: metrics over time, liquidations, or whale trades.

## `summary` (type: `string`):

The OUTPUT record: rows per coin and exchange, or an error code.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "symbols": [
        "BTC",
        "ETH"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("feeddlabs/crypto-derivatives-data").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "symbols": [
        "BTC",
        "ETH",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("feeddlabs/crypto-derivatives-data").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "symbols": [
    "BTC",
    "ETH"
  ]
}' |
apify call feeddlabs/crypto-derivatives-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,feeddlabs/crypto-derivatives-data"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/rgXyzr7zsrT3d56ZH/builds/DbHdJ09y4j8Hcwfvx/openapi.json