Crypto Long/Short Ratio + Open Interest Aggregator (CEX)

Crypto Long/Short Ratio & Open Interest Aggregator — Futures Sentiment Tracker

Aggregate crypto long short ratio and open interest data across Binance, OKX, and Bitget in a single API call. This open interest aggregator delivers per-symbol OI in USD, three independent long/short ratio metrics, and a composite skew label — the essential futures sentiment tracker for identifying crowded trades, liquidation setups, and squeeze candidates. No API key required.

Professional futures traders pay $20–50/month for this data from Coinglass. This Actor delivers the same structured dataset via Apify's cloud execution for a fraction of a cent per run — fully automatable, schedulable, and pipeable into any trading bot or dashboard.

---

What does the Long/Short OI Aggregator do?

The open interest aggregator pulls perpetual futures positioning data simultaneously from three major venues (Binance, OKX, Bitget) and computes aggregate signals per symbol. For each coin it returns: total OI in USD with per-venue breakdown, three independent long/short ratio readings (Binance top-trader-by-position, Binance global-account, OKX top-trader-account), an average L/S ratio, and a skew label — EXTREME_LONG, LONG_SKEWED, NEUTRAL, SHORT_SKEWED, or EXTREME_SHORT. Running on Apify's reliable infrastructure means the multi-venue API fan-out is handled for you, with automatic retries and dataset persistence after every run.

Schedule this Actor every 15 minutes and you get a continuous positioning time-series without managing any servers — Apify stores every dataset permanently and gives you a direct API URL to query from your application.

---

Why use the Long/Short OI Aggregator?

• Liquidation cascade detection. Large OI combined with EXTREME_LONG skew means leveraged longs are over-positioned and primed for a downside cascade. This combination historically precedes sharp wick-downs as stop-losses and liquidations compound.
• Short squeeze identification. The inverse — large OI + EXTREME_SHORT — is the setup professional squeeze traders look for. Spot it before price moves using the ls_short_extreme_desc sort option.
• Position health monitoring. If you hold a leveraged position, knowing whether the crowd is on the same side tells you how much buffer you have before a cascade accelerates against you.
• Cross-venue positioning divergence. Three independent L/S ratio sources let you spot when Binance retail and OKX professional traders are positioned differently — a divergence signal worth acting on.
• OI trend analysis. Falling OI into a price rally signals shorts capitulating; rising OI into resistance signals both sides loading up (volatility incoming). Use the sort options to surface these patterns instantly.

---

How to use the Long/Short OI Aggregator

1. Open the Actor on Apify Store and click Try for free.
2. Leave symbols empty for the bundled top-50 majors seed list, or specify your watchlist.
3. Click Start — results appear within 30–60 seconds.
4. Use the Dataset tab to view JSON/CSV, or copy the API URL for your trading bot.
5. To run continuously, use Apify's Schedule feature. Set alertLsThreshold plus a Telegram bot token to receive push notifications when any symbol crosses an extreme skew threshold.

---

Input

Field	Type	Default	Description
symbols	string[]	[]	Base symbols to track. Empty = bundled top-50 majors list
includeBinance	boolean	true	OI + 2 L/S ratios from Binance USDT-M perpetuals
includeOkx	boolean	true	OI + top-trader L/S from OKX SWAP
includeBitget	boolean	true	OI from Bitget USDT-FUTURES (USD-converted)
lsPeriod	string	1h	L/S ratio 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	Alert when avg L/S ratio crosses this value (e.g. 3 = heavy long crowd)
telegramBotToken	string (secret)	—	Bot token for Telegram alerts
telegramChatId	string	—	Chat ID for Telegram alerts

Example — Track BTC/ETH/SOL crowdedness with extreme-long alert:

{
  "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

Each row represents one symbol's aggregated positioning snapshot:

[
  {
    "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"
  },
  {
    "symbol": "ETH",
    "mark_price": 3812,
    "total_oi_usd": 8740000000,
    "binance_oi_usd": 5100000000,
    "okx_oi_usd": 2100000000,
    "bitget_oi_usd": 1540000000,
    "venues_with_oi": 3,
    "binance_top_trader_ls": 0.78,
    "binance_global_account_ls": 0.91,
    "okx_ls": 0.83,
    "avg_ls_ratio": 0.84,
    "ls_metrics_count": 3,
    "skew_label": "SHORT_SKEWED",
    "timestamp": "2026-06-02T14:00:00+00:00"
  }
]

---

Data fields

Field	Type	Description
symbol	string	Base asset symbol (BTC, ETH, SOL, etc.)
mark_price	float	Current mark price in USD
total_oi_usd	float	Aggregate open interest across all enabled venues
binance_oi_usd	float	Binance USDT-M perpetual OI in USD
okx_oi_usd	float	OKX SWAP perpetual OI in USD
bitget_oi_usd	float	Bitget USDT-FUTURES OI in USD
binance_top_trader_ls	float	Binance top-trader-by-position long/short ratio
binance_global_account_ls	float	Binance global-account long/short ratio
okx_ls	float	OKX top-trader-account long/short ratio
avg_ls_ratio	float	Average of all available L/S ratios
skew_label	string	EXTREME_LONG, LONG_SKEWED, NEUTRAL, SHORT_SKEWED, or EXTREME_SHORT

---

Cost estimation

This Actor uses Pay-Per-Event (PPE) pricing at $0.002 per symbol returned.

Scenario	Symbols	Estimated cost
3 majors (BTC, ETH, SOL)	3	$0.006
Top 10 watchlist	10	$0.02
Full top-50 scan	50	$0.10
Top-10 every 15 min (30 days)	2,880 runs x 10 symbols	$57.60/month

---

FAQ

Q: What is the difference between Binance top-trader and global-account L/S ratios? binance_top_trader_ls counts only the top 20% of accounts by position size — the "smart money" reading. binance_global_account_ls counts all accounts. When they diverge significantly, it often signals retail is overcrowded on one side while institutions position the other way.

Q: Are Binance endpoints available from all regions? Binance may geo-block requests from certain cloud IP ranges. When this happens, the Actor continues using OKX and Bitget data and marks venues_with_oi accordingly — you still get multi-venue coverage.

Q: How often should I poll for meaningful signal? For intraday trading, 15-minute or 1-hour snapshots are the most actionable. Daily snapshots are sufficient for macro positioning analysis. The lsPeriod field should match your polling interval.

Disclaimer: Open interest and long/short ratios are positioning indicators, not directional predictions. Markets can remain irrational longer than any model predicts. This is not financial advice.

---

Live Sample Run

A real run with default settings (2026-06-10):

Field	Value
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

---

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.

Feedback

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

Keywords: crypto long short ratio, open interest aggregator, futures sentiment tracker, crypto OI tracker, Binance open interest, OKX long short ratio, perpetual futures positioning, liquidation cascade detector, short squeeze radar, crypto derivatives data, Bitget open interest, EXTREME_LONG EXTREME_SHORT, futures market sentiment, crypto positioning API, crowded trade detector