Open data · API
Free crypto derivatives API (JSON, no key)
The same JSON our pages are built from: liquidations, open interest, liquidation maps, order book depth and funding rates. Free, no key, no sign-up. CC BY 4.0: credit Edge or Not with a link.
Endpoints
Base address: https://edgeornot.com. Coins: btc, eth, sol, xrp, doge, bnb, ada, sui, link, avax, hype, ena, near, uni, aave, tao, wld, zec, arb, inj (lower case in paths). Times are Unix milliseconds, UTC; money is in USD.
/api/liquidationscache 30 sForced liquidations from Binance and Bybit: totals for longs and shorts, split by exchange, hourly series, by coin, the largest single liquidations and the latest ones. Page: liquidations.
Parameters: hours 1-168 (default 24), coin (optional)
/api/oi/{coin}cache 60 sOpen interest in USD on Binance and Bybit with price, as time series. Page: open interest.
Parameters: days 1, 7 or 30 (default 7)
/api/oi-by-exchangecache 5 minCurrent open interest in USD for 20 coins on Binance, Bybit, OKX, Gate and Hyperliquid: totals and share per exchange, change over 24 hours, and the split for each coin. Page: open interest by exchange.
Parameters: none
/api/liqmap/{coin}cache 120 sOur modeled liquidation map: estimated liquidation levels by price over time and the key levels above and below price. A model, not real orders - see how accurate it is. Page: liquidation heatmap.
Parameters: days 1, 3, 7, 14 or 30 (default 7), ex all, binance, bybit, okx, gate or hyperliquid
/api/book/{coin}cache 60 sOrder book depth by price level over time, with the mid price. Page: liquidity heatmap.
Parameters: hours 1-72 (default 24)
/api/fundingcache 30 sCurrent funding rates on Binance, Bybit, OKX and BingX, normalized to 8 hours, with the spread between exchanges. Page: funding rates.
Parameters: none
/api/funding-history/{COIN}cache 30 minPast funding payments for one coin from Binance (up to the last 1,000) and Bybit (about 6 months), normalized to 8 hours, plus 30-day statistics.
Parameters: none
/api/summarycache 60 sA small snapshot: liquidations in 24 hours, average BTC funding across exchanges, BTC price and the biggest modeled liquidation levels above and below it.
Parameters: none
/api/btc-rainbowcache 15 minThe bitcoin rainbow chart series: price and the band edges. Page: rainbow chart.
Parameters: none
/api/altseasoncache 10 minOur altcoin season index: daily series and the current reading. Page: altcoin season index.
Parameters: none
Examples
curl "https://edgeornot.com/api/liquidations?hours=24&coin=eth" curl "https://edgeornot.com/api/oi/btc?days=7" curl "https://edgeornot.com/api/liqmap/btc?days=7&ex=all"
import requests
d = requests.get("https://edgeornot.com/api/liquidations", params={"hours": 24}).json()
longs, shorts = d["total"]["long"], d["total"]["short"]
print(f"24h liquidations: ${longs + shorts:,.0f}, longs {longs / (longs + shorts):.0%}")
Main fields
/api/liquidations:total(long,shortin USD),by_exchange(long,short,n),series(hourlyt,long,short),coins(coin,long,short,n),biggestandrecent(ex,coin,side,price,usd,ts),count,updated,collected_since./api/oi/{coin}:times,binance,bybit(USD),price- arrays of the same length;symbol,days,updated./api/oi-by-exchange:total(USD),exchanges(ex,name,usd,sharein %,coinscovered,chg24in %),coins(coin,total,usdandshareby exchange),updated./api/book/{coin}:times,price_lo,price_hi,nbins,matrix(resting size per price bin at each time),close,updated.
Rules
- Credit: CC BY 4.0 - name Edge or Not and link to the page or to edgeornot.com.
- Reasonable use: no key and no published quota; poll no faster than the cache time above. Excessive automated traffic may be limited.
- No guarantee: data is provided as is; feeds can be delayed or interrupted, and the format may change. See the terms.
- Not advice: the liquidation map is a model, not real orders. Read the risk disclaimer.
Limits of the data
- Liquidations: Binance (all USDT perpetuals) and Bybit (20 coins). Binance publishes at most one liquidation per symbol per second, so totals are a lower bound.
- Open interest series: Binance and Bybit, about 30 days of history.
- Twenty coins for maps, order book and open interest; USDT-margined perpetuals only.
Tables from our tests (CSV) and charts to embed are on open data.
Changelog
- 25 October 2026: this page published; added
/api/oi-by-exchange(open interest on five exchanges).
FAQ
Is the Edge or Not API free?
Yes. No key, no sign-up. The data is under CC BY 4.0: use it, including commercially, and credit Edge or Not with a link to edgeornot.com.
Is there a rate limit?
There is no published quota. Responses are cached for 30 seconds to 30 minutes, so polling faster than that returns the same data. Excessive automated traffic may be limited without notice.
How complete is the liquidation data?
It covers Binance (all USDT perpetuals) and Bybit (20 major coins). Binance publishes at most one liquidation per symbol per second, so totals are a lower bound of what actually happened.
Is the API stable?
It is the same API our own pages use. We try not to break it, but the format and availability are not guaranteed. Changes are noted in the changelog above.