Volatility regime detection
for crypto markets.

A REST + WebSocket API that reports the current volatility state — low, normal, or high — for BTCUSDT, ETHUSDT, and more. Calibrated on real data. The math is documented. No predictions.

Get an API key Read the docs →

How it works

Three ingredients, all visible.

01 — data

1-minute klines

We pull 1-minute OHLCV from Binance spot. No re-aggregation tricks, no synthetic bars. What the exchange publishes is what we use.

02 — feature

Realized vol, z-scored

30-minute rolling realized volatility, annualized. z-score against a 4-hour baseline. The short window measures now; the baseline measures recent normal.

03 — fsm

Three-state FSM

low / normal / high, with hysteresis. To transition we require several consecutive observations past the boundary; single spikes don't move the state.


Numbers we publish

We show you the score.

Calibration run on 180 days of BTC/ETH 1m klines, 2,304 parameter combinations. Three named presets on the Pareto front.

conservative
2.6 alerts/day
F1 0.37
quiet, high precision
balanced default
5.6 alerts/day
F1 0.39
the knee of the curve
aggressive
14 alerts/day
F1 0.41
max F1, higher noise

Median detection lag: ~20 minutes. That is the honest number; we publish it rather than hide it. Regime detection against a smoothed percentile ground truth is genuinely noisy — anyone claiming F1 > 0.9 is labeling with future information.


The API

One curl. That's the onboarding.

$ curl https://amaneki.com/v1/regime/btcusdt

{
  "symbol":        "btcusdt",
  "regime":        "normal",
  "z_vol":         -1.39,
  "realized_vol":  0.1788,
  "baseline_vol":  0.2374,
  "close":         73923.87,
  "last_update_ms": 1776236100000,
  "last_transition": null
}
GET /v1/regime/{symbol}
GET /v1/regime/{symbol}/history
WS  /v1/stream

Pricing

Pay what a developer pays.

Free
$0
  • — 1,000 requests / month
  • — 15-minute delay
  • — BTCUSDT, ETHUSDT
  • — Community support
Hobby
 
$29/mo
  • — 100,000 requests / month
  • — Real-time
  • — All current symbols
  • — Discord webhook alerts
  • — Email support
Pro
$99/mo
  • — 1,000,000 requests / month
  • — WebSocket stream
  • — All symbols + custom presets
  • — Historical data download
  • — Priority support

Enterprise / volume: hello@amaneki.com