VOOZH about

URL: https://apify.com/gochujang/long-short-oi-aggregator

โ‡ฑ Crypto Long/Short Ratio + Open Interest Aggregator (CEX) ยท Apify


๐Ÿ‘ Crypto Long/Short Ratio + Open Interest Aggregator (CEX) avatar

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

Pricing

$2.00 / 1,000 symbol trackeds

Go to Apify Store

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

Long/short ratio + open interest across Binance/OKX/Bybit/Coinglass for any perp pair. Detect over-leveraged positioning before liquidation cascades. PPE $0.002/symbol. Telegram alerts on L/S threshold.

Pricing

$2.00 / 1,000 symbol trackeds

Rating

0.0

(0)

Developer

๐Ÿ‘ Hojun Lee

Hojun Lee

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

10 days ago

Last modified

Share

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

FieldTypeDefaultDescription
symbolsstring[][]Base symbols. Empty = bundled top-50 majors seed list
includeBinancebooleantrueOI + 2 L/S ratios from Binance USDT-M
includeOkxbooleantrueOI + top-trader L/S from OKX SWAP
includeBitgetbooleantrueOI from Bitget USDT-FUTURES (USD-converted via mark)
lsPeriodstring1hBinance L/S window: 5m, 15m, 30m, 1h, 2h, 4h, 1d
sortBystringoi_descoi_desc, ls_long_extreme_desc, ls_short_extreme_desc, symbol_asc
alertLsThresholdnumber0Telegram alert when avg L/S crosses this (e.g. 3 = heavy long crowd)
telegramBotTokenstring (secret)โ€”Bot token for alerts
telegramChatIdstringโ€”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



๐ŸŽฌ Live Sample Run

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

FieldValue
Items in dataset2
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 detailshttps://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

You might also like

Funding Pulse

fraktalapi/funding-pulse

Real-time funding rates, open interest, liquidations, long/short ratios, and cross-exchange spread signals from Bybit, Binance, OKX, Bitget, dYdX, and Hyperliquid. CoinGlass alternative at a fraction of the price.

CoinGlass Crypto Derivatives Data Scraper

gentle_cloud/coinglass-crypto-derivatives-scraper

Scrape crypto derivatives data from CoinGlass โ€” funding rates, open interest, liquidations, long/short ratios, options, and Bitcoin on-chain indices across all major exchanges.

Nasdaq Short Interest Scraper

parseforge/nasdaq-short-interest-scraper

Pull bimonthly short interest from Nasdaq for any US ticker, returning symbol, settlement date, short interest shares, average daily volume, days to cover, and percent change. Useful for tracking squeeze candidates, hedge fund positioning, and equity research workflows.

Coinglass Coin Markets

api_merge/coinglass-coin-markets

Fetch CoinGlass coin markets data for any supported exchange. Select an exchange and page to get clean JSON output with market symbols, current prices, funding rates, market cap, open interest, price changes, volume changes, long/short ratios, and liquidation metrics.

CoinGlass Liquidation Map

api_merge/coinglass-liquidation-map

Fetch CoinGlass liquidation map data for futures trading pairs. Search supported instruments, select a range, and get clean JSON output showing mapped liquidation price levels, liquidation size, and leverage ratio

CoinGlass Liquidation Heatmap

api_merge/coinglass-liquidation-heatmap

Fetch CoinGlass liquidation heatmap data for any supported market symbol. Select a symbol, model, and time interval to get clean JSON output with price levels, liquidation leverage data, candlesticks, and update time.

13

5.0

Coinglass Liquidation Max Pain

api_merge/coinglass-liquidation-max-pain

Fetch CoinGlass liquidation max-pain prices for major cryptocurrencies. Select a time range to get clean JSON rows with current price, long max-pain liquidation level and price, and short max-pain liquidation level and price.