OKX data · site proxy
Last refresh: loading
Period: 5 minutes · 30-point window
Currency account ratioBTC
—
loading
Top Trader accountsBTC
—
loading
Top Trader positionsBTC
—
loading
Currency account ratioETH
—
loading
Top Trader accountsETH
—
loading
Top Trader positionsETH
—
loading

How to read the six numbers

The currency account ratio describes how accounts are distributed across expiry and perpetual futures. OKX does not label that population as retail. A high reading means relatively more net-long accounts and a low reading means relatively more net-short accounts; it does not measure net flow, position changes or the next price move.

The Top Trader lines only describe the distribution inside the top 5% of accounts for a specified contract. The ranking uses open position value and has no win-rate filter. A different direction from the currency account ratio means the samples show different snapshots; it is not automatically bullish or bearish.

Levels such as 2.5, 0.4, 1.5 and 0.6 are informal observation lines, not official OKX thresholds, and this site has no reproducible study supporting them. Compare each endpoint and parameter set against its own recent distribution instead.

Trend matters more than the snapshot

Single-point values bounce, and 30 points help show whether a ratio is changing persistently. If the Top Trader position ratio moves from 1.1 to 1.7 over two hours, that only shows long position value rose relative to short position value in that sample. The ratio alone cannot separate new longs, closed shorts or sample changes.

When a ratio sits near 1.0, the numerator and denominator for that series are close. It does not establish that the wider market has no opportunity, that total exposure is balanced, or that price will stay quiet.

What each of the three ratios actually counts

The six cards above are three measurements, each run once on BTC and once on ETH. Every one of them divides a different thing by a different thing, which means every one of them supports a different conclusion. Mixing them is the quickest way to argue yourself into two opposite reads off the same screen.

Metric Numerator ÷ denominator A high reading means A low reading means The usual misread
Currency account ratio Net-long ÷ net-short accounts across expiry and perpetual futures for one currency More people are standing on the long side More people are standing on the short side Taking it as money on each side. It never looks at how much any account actually put down.
Top Trader account ratio Net long accounts ÷ net short accounts inside the top 5% by open position value More of that cohort is pointed long More of that cohort is pointed short Taking it as a copy-trade feed. You can't see their entries, their leverage or their stops.
Top Trader position ratio Long notional ÷ short notional for that same cohort, weighted by position size More money is parked on the long side More money is parked on the short side Taking it as net exposure. Hedge legs and basis trades are counted in there too.

Only the two Top Trader series share the same instId and top-5% sample, so use those for a direct account-versus-position comparison. A low account ratio with a high position ratio means more sampled accounts are net short while long position value is larger; the reverse means more accounts are net long while short position value is larger. The data do not reveal entries, leverage, hedge legs or net flow. The full guide explains all four official scopes.

Thresholds do not automatically travel between symbols. This page has no account-count evidence showing that one coin's ratio is inherently slower. Compare each symbol against its own history using the same endpoint and parameters rather than one shared line.

One more limit is written straight into the panel settings: it plots the last 30 points of the 5-minute series, so the x-axis spans roughly two and a half hours end to end. The 60-second refresh only swaps the right-hand point for a newer one — it doesn't stretch the window. For a multi-day view you either log a reading yourself at the same hour each day, or read this panel next to a daily candle chart. Asking a two-and-a-half-hour curve whether a trend has turned is a scale mismatch before you even look at the number.

API addresses: you can pull these four yourself

The six cards read OKX Rubik statistics through this site's same-origin proxy; no API key is needed. The currency account ratio uses ccy, while contract and Top Trader ratios use instId. This dashboard displays the currency account series and the two Top Trader series.

Currency account ratio (expiry + perpetual futures): GET https://www.okx.com/api/v5/rubik/stat/contracts/long-short-account-ratio?ccy=BTC&period=5m

Per-contract account ratio: GET https://www.okx.com/api/v5/rubik/stat/contracts/long-short-account-ratio-contract?instId=BTC-USDT-SWAP

Top Trader account ratio: GET https://www.okx.com/api/v5/rubik/stat/contracts/long-short-account-ratio-contract-top-trader?instId=BTC-USDT-SWAP

Top Trader position ratio: GET https://www.okx.com/api/v5/rubik/stat/contracts/long-short-position-ratio-contract-top-trader?instId=BTC-USDT-SWAP

The documented limits: the currency series accepts 5m / 1H / 1D with 2-day / 30-day / 180-day lookbacks and a limit of 5 requests per 2 seconds per IP. Each contract endpoint can retrieve the latest 1,440 entries, but limit defaults to 100 and is capped at 100 per request; the rate limit is 5 requests per 2 seconds per IP plus instrument ID. Top Trader data starts on 2024-03-22.