Aperiodic IndicesPositioningNew
The part of the open interest move that price doesn’t explain. Large readings come with squeezes and forced unwinds.
Beyond ±2, positions moved far more than the price move explains: the mark of squeezes and forced unwinds.
The part of open interest that tracks price is taken out, so what’s left adds to a model rather than repeating it.
Several perps diverging at once points to positioning stress across the market, not one coin’s news.
Are positions moving more than price explains?
−0.89σ
Within ±1 (−0.89): positions are moving about as much as price explains.
+1.43usual swings
15:30 UTC, 13 May · open interest +0.39% in the hour
+1.43: positions are opening beyond what price explains.
Bars by the size of open_interest_divergence, in five equal groups. Basis points.
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.
positioning.open_interest_divergenceThe 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.
Step 1
Open interest is counted in contracts, so a price move alone doesn't change it. The mean is over the bars before this one.
Step 2
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.
open_interest_divergence on each bar: above 0 positions are being added beyond what price explains, below 0 closed.
Step 3
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.
Step 4
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.
Step 5
positioning.open_interest_divergenceFor every perpetual on Binance, OKX and Hyperliquid, at every interval from 1 minute to 1 day, on exchange and receive timestamps.
In Prime and up, from $399/month billed yearly.
The example needs no key and returns the free sample: BTC-USDT on Binance, 5m bars, May 2025.
Or have your agent pull the last 30 days. Start in ClaudeClaude CodeCodexSee the prompt
# 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"