Coverage
What you get
| Item | Detail |
|---|---|
| Product code | CR-DERIVATIVES |
| Coverage | Perpetual and dated futures on the crypto exchanges we carry: funding rates, open interest, mark and index price, basis, long/short and taker ratios, liquidations |
| Granularity | Every funding interval (8 hours on most venues); open interest and ratios at 5-minute (Starter) and 1-minute (Pro) |
| History | Settled funding history for all perps on Free; long 1-minute history on Pro |
| Delivery | REST, WebSocket for live liquidations, CSV or Parquet files |
| Update speed | Live on Pro; funding as each interval settles |
Perpetual futures have no expiry, so exchanges use funding payments to keep them near spot. When longs pay shorts a lot, the market is crowded long. Open interest tells you how much size is at stake, and liquidations show where it got flushed. Most sources keep only days of minute-level history; this product is built around keeping it.
Schema
Schema
Funding and open-interest fields match our published samples.
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Contract, e.g. BTC-USDT-PERP |
exchange |
string | yes | Venue code |
contract_type |
string | yes | perpetual or future |
timestamp |
string | yes | ISO 8601 UTC |
mark_price |
number | yes | Exchange mark price |
index_price |
number | yes | Underlying spot index |
last_price |
number | optional | Last traded price |
funding_rate |
number | yes (perps) | Current or settled funding rate per interval |
predicted_funding_rate |
number | optional | Next estimated rate |
is_settled_funding |
boolean | optional | True when the rate was actually paid |
funding_interval_hours |
number | optional | e.g. 8 |
next_funding_time |
string | optional | ISO 8601 UTC |
annualized_rate_pct |
number | optional | funding_rate times payments per year times 100 |
open_interest |
number | yes | Open contracts in base units |
open_interest_usd |
number | yes | Open interest in USD |
basis_pct |
number | optional | (mark minus index) / index, annualized for futures |
global_long_short_ratio |
number | optional | Accounts long / short |
taker_buy_sell_ratio |
number | optional | Taker buy volume / taker sell volume |
Liquidation records carry symbol, exchange, timestamp, side (long or short position closed), price, size and notional_usd.
Example record (illustrative):
{
"symbol": "BTC-USDT-PERP",
"exchange": "binance",
"contract_type": "perpetual",
"timestamp": "2026-11-01T00:00:00Z",
"mark_price": 77568.3,
"index_price": 77541.9,
"last_price": 77570.0,
"funding_rate": 0.00008482,
"predicted_funding_rate": 0.00007915,
"is_settled_funding": true,
"funding_interval_hours": 8,
"next_funding_time": "2026-11-01T08:00:00Z",
"annualized_rate_pct": 9.288,
"open_interest": 96913.056,
"open_interest_usd": 7510208385.69,
"basis_pct": 0.034,
"global_long_short_ratio": 2.57410739,
"taker_buy_sell_ratio": 0.370209
}
Sample data
Sample data
Bitcoin Perpetual Funding Rates. Every 8-hour funding rate for the BTC perpetual, September to October 2026. First 10 rows:
| symbol | timestamp | funding_interval_hours | funding_rate | annualized_rate_pct |
|---|---|---|---|---|
| BTC-USDT-PERP | 2026-09-01T00:00:00Z | 8 | 0.00008482 | 9.288 |
| BTC-USDT-PERP | 2026-09-01T08:00:00Z | 8 | 0.0001 | 10.95 |
| BTC-USDT-PERP | 2026-09-01T16:00:00Z | 8 | 0.00003844 | 4.209 |
| BTC-USDT-PERP | 2026-09-02T00:00:00Z | 8 | 0.00007995 | 8.755 |
| BTC-USDT-PERP | 2026-09-02T08:00:00Z | 8 | 0.00007998 | 8.758 |
| BTC-USDT-PERP | 2026-09-02T16:00:00Z | 8 | 0.00003819 | 4.182 |
| BTC-USDT-PERP | 2026-09-03T00:00:00Z | 8 | 0.00007287 | 7.979 |
| BTC-USDT-PERP | 2026-09-03T08:00:00Z | 8 | 0.00005866 | 6.423 |
| BTC-USDT-PERP | 2026-09-03T16:00:00Z | 8 | 0.00008893 | 9.738 |
| BTC-USDT-PERP | 2026-09-04T00:00:00Z | 8 | 0.00008558 | 9.371 |
Source: Binance
Bitcoin Open Interest and Long/Short Ratios. 5-minute snapshots for 1 November 2026. First 10 rows:
| symbol | timestamp | open_interest | open_interest_usd | top_trader_long_short_ratio | global_long_short_ratio | taker_buy_sell_ratio |
|---|---|---|---|---|---|---|
| BTC-USDT-PERP | 2026-11-01T00:00:00Z | 96913.056 | 7510208385.69 | 2.73066972 | 2.57410739 | 0.370209 |
| BTC-USDT-PERP | 2026-11-01T00:05:00Z | 96910.742 | 7510436857.99 | 2.73116161 | 2.57473332 | 0.818188 |
| BTC-USDT-PERP | 2026-11-01T00:10:00Z | 96896.092 | 7508720409.31 | 2.73000059 | 2.57199349 | 1.108301 |
| BTC-USDT-PERP | 2026-11-01T00:15:00Z | 96902.868 | 7511115723.84 | 2.72960743 | 2.57215056 | 0.846182 |
| BTC-USDT-PERP | 2026-11-01T00:20:00Z | 96804.786 | 7506321933.4 | 2.7270325 | 2.5660222 | 1.796444 |
| BTC-USDT-PERP | 2026-11-01T00:25:00Z | 96767.801 | 7506365414.59 | 2.7299521 | 2.5683359 | 1.407232 |
| BTC-USDT-PERP | 2026-11-01T00:30:00Z | 96645.236 | 7503250870.42 | 2.72941764 | 2.56856201 | 1.966198 |
| BTC-USDT-PERP | 2026-11-01T00:35:00Z | 96614.423 | 7498199446.37 | 2.7310134 | 2.57038727 | 0.55517 |
| BTC-USDT-PERP | 2026-11-01T00:40:00Z | 96598.175 | 7495560190.71 | 2.73124063 | 2.57009464 | 0.554578 |
| BTC-USDT-PERP | 2026-11-01T00:45:00Z | 96605.934 | 7498602704.97 | 2.7305669 | 2.56959993 | 1.67981 |
Source: Binance
Ethereum Perpetual Funding Rates. Same layout as the BTC file, for the ETH perpetual. Download ZIP (183 rows, 5.1 KB)
Source: Binance
Use cases
Use cases
Funding as a sentiment gauge. Average annualized_rate_pct over the last 7 days. A reading well above normal means longs are paying heavily to stay in, which is often when a long squeeze hurts most. Negative funding flags crowded shorts.
Cash-and-carry yield. Hold spot and short the perp to collect funding_rate each interval. Sum settled rates (is_settled_funding true) over a quarter to see what the trade actually paid, before fees.
Open interest plus price. Rising open_interest_usd with rising price means new longs are entering. Falling open interest during a sell-off is positions being closed or liquidated, which you can confirm against liquidation records.
Positioning skew. When global_long_short_ratio sits far above 1 while taker_buy_sell_ratio drops below 1, most accounts are long but aggressive flow is selling. That mismatch is worth an alert.
Code
Code examples
Example: BTC perpetual funding history.
curl "https://api.marketdata.co/v1/crypto/funding?symbol=BTC-USDT-PERP&exchange=binance&start=2026-09-01" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, 7-day rolling funding from the free sample.
import pandas as pd
f = pd.read_csv("btc-perp-funding-rates.csv", parse_dates=["timestamp"])
f = f.set_index("timestamp").sort_index()
f["apr_7d"] = f["annualized_rate_pct"].rolling("7D").mean()
print(f[["funding_rate", "annualized_rate_pct", "apr_7d"]].tail())
Pricing
Pricing
| Plan | Funding, OI and liquidations |
|---|---|
| Free, $0 | Settled funding history for all perps |
| Starter, $29/mo | Adds open interest, long/short and basis history at 5-minute resolution |
| Pro, $79/mo | Adds the live liquidation stream and 1-minute history |
| Business, $249/mo | Commercial use |
Dataset: funding and open interest history at $9 per contract for all years, or $99 for all contracts on one exchange. Among the providers we studied, free tiers exist, and paid plans run from $35 to $750 a month, median $64.
Side by side
How we compare
8 of the 50 providers we studied sell this data. The cheap ones tend to keep minute-level history for days, not years, and the deep ones start at hundreds of dollars a month. We aim for long, clean minute history at $79, a listed price per contract for files, and the same symbol and timestamp layout as our crypto bars and trades.
FAQ
Frequently asked questions
How is the annualized funding rate calculated?
annualized_rate_pct is funding_rate times the number of payments per year times 100. For an 8-hour interval that is 1,095 payments, so 0.0001 per interval becomes 10.95%.
What does "settled" funding mean?
is_settled_funding is true when the rate was actually paid at the funding time. Before that, exchanges publish a predicted rate, which we store separately in predicted_funding_rate.
What time zone are timestamps in?
UTC. On Binance the 8-hour funding times are 00:00, 08:00 and 16:00 UTC, which you can see in the sample.
Do you have liquidation history?
Liquidations are planned as a live stream on Pro, with history kept from the day we start recording. Exchanges limit how far back they publish liquidations, so that history only grows forward.
Is this real-time?
Funding history and 5-minute data are not tick-by-tick. Live liquidations and 1-minute data come with Pro.
Can I use it commercially?
Commercial use starts at Business. For the free Binance samples, check Binance's terms before any commercial display.
Keep reading
Related
- Asset hub: Crypto
- Symbols: BTC-USD, ETH-USD, SOL-USD, XRP-USD, BNB-USD, DOGE-USD
- Docs: API Reference: Funding, Open Interest and Liquidations
- Learn: Crypto Funding Rates Explained, Reading Crypto Liquidations and Open Interest