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 across 5 venues with OI + L/S overlay.
• Hyperliquid Whale Tracker — Specific trader positions to complement aggregate OI.
• Smart Money Wallet Tracker — Spot-market whale activity.

---

Feedback

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