Each bar votes +1 if buyers won it and −1 if sellers did. The votes are averaged with the newest counting most, so it measures persistence, not size.
Above +0.5, buyers have won most bars of the last several hours. Hold a trend trade while it stays there.
Size is ignored, so a steady run of buyer-won bars shows and one block trade doesn’t.
Price at new highs while Conviction slides toward 0 means buyers are winning fewer and fewer bars.
Who has been winning, bar after bar?
+0.10
Buyers won 41 of the last 72 bars, newest counted most: buyers have the upper hand.
+0.12of ±1
6 hours to 08:40 UTC, 20 Nov
Buyers won 41 of the last 72 bars, newest counted most: buyers have the upper hand.
Bars by conviction, in five equal groups. Basis points.
In May, BTC fell 5.75 bps on average in the hour after its most one-sided buying, and rose in every other group.
flow_indices.convictionThe 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
Sellers took slightly more of this bar's notional. The figure swings bar to bar: it says who won one bar, not who has been winning.
flow_pressure on each 5-minute bar of the day: above 0 buyers took more notional, below 0 sellers did.
Step 2
Over the day, buyers won 139 bars and sellers 149. Each bar counts once however much traded, so one block trade can't carry the day.
The last 6 hours of votes: +1 for a bar buyers won, −1 for one sellers won.
Step 3
Close to 0: over the last hours the wins were split almost evenly. Near ±1 one side would have won nearly every bar.
conviction through each bar. A vote 6 hours old counts e⁻¹ ≈ 37% as much as this bar's.
Step 4
flow_indices.convictionFor 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 flow_indices --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"