Crypto Long/Short + Open Interest Aggregator

Aggregate perpetual open interest (USD) and long/short ratios across Binance, OKX, and Bitget. Spot crowded positioning, liquidation candidates, and trader skew. No API key required.

---

What It Does

Pulls per-symbol perpetual futures positioning data from three venues and computes aggregate signals:

• Total OI in USD across all enabled venues + per-venue breakdown
• 3 different long/short ratios: Binance top-trader-by-position, Binance global-account, OKX top-trader-account
• Average L/S + skew label: EXTREME_LONG / LONG_SKEWED / NEUTRAL / SHORT_SKEWED / EXTREME_SHORT
• Configurable L/S period (5m, 15m, 1h, 4h, 1d)

---

Why This Matters

Open interest tells you how much money is in the trade; long/short ratio tells you which side is crowded. Together they predict where liquidation cascades start:

• Large OI + EXTREME_LONG = primed for downside cascade (longs over-positioned)
• Large OI + EXTREME_SHORT = primed for short squeeze
• OI dropping while price rises = shorts capitulating (continuation signal)
• OI rising into resistance = both sides loading up (volatility coming)

This is the same data Coinglass charges $20-50/month for, served as a clean API for your bot or dashboard.

---

Input

Field	Type	Default	Description
symbols	string[]	[]	Base symbols. Empty = bundled top-50 majors seed list
includeBinance	boolean	true	OI + 2 L/S ratios from Binance USDT-M
includeOkx	boolean	true	OI + top-trader L/S from OKX SWAP
includeBitget	boolean	true	OI from Bitget USDT-FUTURES (USD-converted via mark)
lsPeriod	string	1h	Binance L/S window: 5m, 15m, 30m, 1h, 2h, 4h, 1d
sortBy	string	oi_desc	oi_desc, ls_long_extreme_desc, ls_short_extreme_desc, symbol_asc
alertLsThreshold	number	0	Telegram alert when avg L/S crosses this (e.g. 3 = heavy long crowd)
telegramBotToken	string (secret)	—	Bot token for alerts
telegramChatId	string	—	Chat ID for alerts

Example: Track BTC/ETH crowdedness, alert on extreme long-skew

{
  "symbols": ["BTC", "ETH", "SOL"],
  "lsPeriod": "1h",
  "alertLsThreshold": 3,
  "telegramBotToken": "<token>",
  "telegramChatId": "<chat>"
}

Example: Find biggest OI altcoins right now

{
  "sortBy": "oi_desc",
  "lsPeriod": "1h"
}

---

Output

{
  "symbol": "BTC",
  "mark_price": 68763,
  "total_oi_usd": 12450000000,
  "binance_oi_usd": 7557329774,
  "okx_oi_usd": 2617294488,
  "bitget_oi_usd": 2403000000,
  "venues_with_oi": 3,
  "binance_top_trader_ls": 1.4455,
  "binance_global_account_ls": 2.1027,
  "okx_ls": 2.0,
  "avg_ls_ratio": 1.8494,
  "ls_metrics_count": 3,
  "skew_label": "LONG_SKEWED",
  "timestamp": "2026-06-02T14:00:00+00:00"
}

---

Pricing

Pay-Per-Event (PPE):

• $0.002 per symbol returned

Examples:

• Top 50 symbols: $0.10
• 10 majors per minute (1440 runs/day): $2.88/day

---

Use Cases

Liquidation hunter — Find symbols with large OI + extreme L/S skew (cascade primed):

curl -X POST "https://api.apify.com/v2/acts/gochujang~long-short-oi-aggregator/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sortBy": "ls_long_extreme_desc"}'

Squeeze radar — Alert when any major flips to EXTREME_SHORT (capitulation buy signal):

{
  "symbols": ["BTC", "ETH", "SOL", "HYPE"],
  "alertLsThreshold": 0.4,
  "telegramBotToken": "<token>",
  "telegramChatId": "<chat>"
}

---

Data Sources

• Binance: /fapi/v1/openInterest + /futures/data/topLongShortPositionRatio + /futures/data/globalLongShortAccountRatio
• OKX: /api/v5/public/open-interest + /api/v5/rubik/stat/contracts/long-short-account-ratio
• Bitget: /api/v2/mix/market/open-interest

All public, no auth. Note: Binance may be geo-blocked from some cloud IPs — if that happens, OKX + Bitget continue to provide coverage.

---

Related Actors

• CEX Funding Rate Aggregator — Funding rates with carry-trade calculator.
• Hyperliquid Whale Tracker — Specific trader positions to complement aggregate OI.
• Polymarket Odds Tracker — Prediction-market context when positioning extremes coincide with events.
• Smart Money Wallet Tracker — Spot-market whale activity to validate OI signals.

---

---

🎬 Live Sample Run

A real run of this actor with default-ish inputs, executed on 2026-06-10:

Field	Value
Items in dataset	2
Dataset (JSON)	https://api.apify.com/v2/datasets/lfnmT1gjm3BetF671/items?clean=1&format=json
Dataset (CSV)	https://api.apify.com/v2/datasets/lfnmT1gjm3BetF671/items?clean=1&format=csv
Run summary (KVS)	https://api.apify.com/v2/key-value-stores/BagYmaqEu0Kj75wph/records/SUMMARY
Run details	https://api.apify.com/v2/actor-runs/95i0rGBbTvRhe8SW0

Try it now: pop any of the dataset URLs in your browser to see live output, or hit the API endpoints from your code.

Want to reproduce? Click Try Actor on the Apify Store page and use the input defaults shown above.

Feedback

If this Actor saves you time, a quick review helps others find it: Leave a review on Apify Store