Aperiodic
Metrics
MarketsLive
DocsPricing
Get the data

Metrics library · Derivatives

Positioning

Sample CSV
BTC-USDT perpetual on Binance, 5m bars, 1 to 31 May 2025, from the free preview. The free delayed feed doesn't carry this dataset; paid plans stream it in real time.
How it's builtBTC, May 2025FieldsDownloadFAQ

Whether positions are being opened or closed faster than usual, and whether price alone explains it.

Whether positions are building or unwinding beyond what price explains, how large open interest is against daily trading, and the funding paid on new positions.

Built from
Open Interest, Derivative Price, Funding, Flow Metrics
Fields
3
Intervals
15m to 1d
Plan
Prime
Venues
Binance, OKX, Hyperliquid
Live
Real time on paid plans

How it's built

One real 5-minute bar from the free preview, field by field.

The day of 5m bars up to the bar from 14:00 to 14:05 UTC on 14 May 2025, Binance BTC-USDT perpetual, from the free preview.

  1. Step 1

    Open interest against its 12-hour level

    gap=ln OI 11.3029 − 12h mean 11.3132=−0.0103

    Open interest is counted in contracts, so a price move alone doesn't change it. The mean is over the bars before this one.

    11.33511.302
    14:05, 13 May14:00, 14 May
    ln open interest (contracts)12-hour time-decayed mean
  2. Step 2

    Take out what price explains

    open_interest_divergence=(build − β × price build) ÷ its 7-day RMS=−0.893

    The build is the gap in units of its 7-day RMS, so one threshold reads on BTC and on a thin listing; the price build is the same score on the log mark price. β is a 7-day time-decayed fit of one on the other, both clipped at ±3, so a crash doesn't set it for the week after. What is left is positions moving beyond what price explains.

    +1.4−1.0
    14:05, 13 May14:00, 14 May

    open_interest_divergence on each bar: above 0 positions are being added beyond what price explains, below 0 closed.

  3. Step 3

    Against a day's trading

    leverage_index=OI $8.41B ÷ typical day $17.33B=0.486

    The typical day is a 7-day time-decayed mean of daily taker notional, over the days before this bar's; the plain mean of the last seven days was $19.46B. Open positions came to 0.49 of a typical day's trading.

  4. Step 4

    Funding paid to add positions

    crowding=1e4 × day's funding 0.0079% × max(0, OI growth)=0.000

    The growth is 100 × (ln OI − its 3.5-day mean). Open interest was shrinking on this bar, so crowding is 0 however high funding is: no one is paying to pile in. Positive means longs pay to add, negative that shorts do.

  5. Step 5

    The bar

    open_interest_divergence
    −0.8932
    leverage_index
    0.4857
    crowding
    0.0000

Whether BTC moved more after open interest broke from price

In May, BTC's median move over the next hour was 1.2× larger after the fifth of bars where open interest broke furthest from price.

BTC-USDT perpetual on Binance, 5m bars, 1 to 31 May 2025, from the free preview.

Median BTC move over the next hour
18.1
19.0
18.1
19.4
21.4
Smallest2nd3rd4thLargest

Bars by the size of open_interest_divergence, in five equal groups. Basis points.

Sorted into five equal groups by the size of open_interest_divergence, the largest fifth was followed by a median 21.4 bps move over the next hour, against 18.6 bps for the rest. The divergence itself carries no direction: it correlates -0.07 with the bar's return.

The most extreme reading was -4.50 at 2025-05-08 21:20 UTC, as BTC rose 230.0 bps in an hour while positions closed: a short squeeze. Crowding was 0 on 51% of bars, the ones where positions weren't being added, and the leverage index ranged from 0.38 to 0.59.

How to read it

open_interest_divergence starts from the build: log open interest, counted in contracts so price moves don't enter it, against its 12-hour time-decayed mean, in units of how far it usually strays. It removes from that what the same build on mark price explains, using a 7-day beta. What is left is positions being added (above 0) or closed (below 0) beyond what price explains, scaled to about one in normal times. Large readings come with liquidations and squeezes; NULL while open interest or price is flat.

leverage_index is open interest notional divided by a week's time-decayed mean of daily traded notional, over the days before the bar's: how many days of trading the open positions add up to. It rises as leverage builds and drops sharply after a flush.

crowding multiplies the day's time-decayed funding rate by how much open interest grew over 3.5 days, and is 0 while it shrank. Positive means longs are paying to pile in, negative that shorts are. It is in basis points per venue funding period, so compare it within a venue.

open_interest_divergence
The open interest build (log open interest in contracts minus its 12-hour time-decayed mean, in units of that gap's 7-day root mean square, both over the bars before) left after removing what the same build on mark price explains (a 7-day time-decayed beta, both clipped at ±3), in units of its own 7-day root mean square. Positions building (above 0) or unwinding (below 0) beyond what price explains; uncorrelated with price
leverage_index
Open interest notional divided by the 7-day time-decayed mean of daily taker notional, over the days before the bar's day. Open interest per dollar a day trades
crowding
1e4 × 1-day time-decayed funding rate × max(0, 100 × (log open interest − its 3.5-day time-decayed mean)). Funding, in bps per venue funding period, paid on positions being added; 0 while positions shrink

Download the same month

No account needed. Run one command, or hand it to your agent.
# Install the Aperiodic CLI into ~/.local/bin
mkdir -p "$HOME/.local/bin"
curl -fsSL https://raw.githubusercontent.com/aperiodic-io/cli/main/install.sh | INSTALL_DIR="$HOME/.local/bin" bash
export PATH="$HOME/.local/bin:$PATH"

# Free preview — no API key required
aperiodic positioning --preview \
  --exchange binance-futures \
  --symbol perpetual-BTC-USDT:USDT \
  --interval 5m \
  --timestamp exchange \
  --start-date 2025-05-01 \
  --end-date 2025-05-31 \
  --output-dir ./data && echo "Saved to $PWD/data"

Every venue and perp, from 1-minute to daily bars, comes with Prime.

Positioning in the API docs: its endpoint and parameters →

Questions

Related

Open interestContracts held open, and how fast it changesFundingWhat longs pay shorts, every perpFlow indicesHow one-sided taker flow has been, and in this bar
Aperiodic

Built from hundreds of terabytes of raw data and distilled into point-in-time metrics you can pull as parquet files. Plus the raw trades, quotes and derivatives data behind them.

Data
  • Metrics library
  • Order Flow
  • L1 & L2
  • Derivatives
  • Raw Data
  • Data Catalog
  • Free data
  • Pricing
Use Cases
  • Improve your backtest
  • Find new alpha
  • Execute smarter
Indices
  • All indices
  • Flow indices
  • Pressure Index
  • Conviction Index
  • Positioning indices
  • OI Divergence Index
  • Leverage Index
  • Crowding Index
  • Liquidity indices
  • Cost Index
  • Depth Index
  • Impact Index
Tokenized markets
  • All real-world assets
  • Commodity perps
  • Tokenized stock perps
  • Stock index perps
  • Tokenized ETF perps
  • Pre-IPO perps
  • FX perps
  • Hyperliquid HIP-3
Live markets
  • Live markets dashboard
  • Every perp, A–Z
  • Real-world asset board
  • Global Liquidity
  • Unusual activity
  • Live funding rates
Developers
  • Docs
  • API Docs
  • MCP Server
  • For AI Agents
  • Pre-flight
  • Notebooks
  • Integrations
  • Atlas Security Master
  • TParquet
  • llms.txt
Learn
  • Markets from First Principles
  • Microstructure Guide
  • Replays
  • Architecture
  • Research Blog
  • FAQ
Company
  • Team
  • Contact
  • Book a call
  • Changelog
  • Roadmap
Compare
  • All vendors
  • Pricing compared
  • vs. Tardis
  • vs. CoinGlass
  • vs. Kaiko
  • vs. Amberdata
  • vs. Crypto Lake
  • vs. Laevitas
  • vs. Coinalyze
Exchange data
  • Binance archive
  • Hyperliquid data
  • Binance OI history API
  • OKX history APIs

© Copyright 2026 Aperiodic. All Rights Reserved.

Aperiodic Limited · Registered in Ireland · Company No. 815273 ·
136 Capel Street, Dublin D01 T2C9, Ireland
Terms of ServicePrivacy PolicyLicensingSLA