Liquidation Levels API: data sheet

Where the liquidation walls sit on each coin, how big they are, how far from the mark, how old, and how much evidence stands behind each one. One JSON object per coin from GET https://hunterkiller.io/api/v1/levels/{symbol}. The numbers are the ones the Hunter Killer dashboard shows at the same snapshot.

Endpoints

Path	What it returns	Auth
`GET /api/v1/levels/{symbol}`	Levels for one coin	Key, Pro session or x402
`GET /api/v1/levels?symbols=A,B`	Up to 10 coins, metered one call per coin	Key or Pro session
`GET /api/v1/levels/symbols`	Covered coins per tier and the Free delay	None
`GET /api/v1/levels/usage`	Your key's metered calls today (UTC)	Key
OpenAPI 3.0 description	Every path, parameter and field above, machine readable	None

Fields

Field	Meaning
`as_of`, `as_of_iso`, `age_sec`	Snapshot time every number is measured at, and its age when served.
`tier`, `delay_sec`	`delayed` with 7200 on a free key; the paid tiers read the current snapshot with 0.
`mark.price`, `mark.basis`	The one reference price for every distance (`realtime` or `delayed_snapshot`).
`nearest.above`, `nearest.below`	The biggest wall each side within 1 to 5 percent of the mark; `beyond_band` when a side only has one further out (up to 15 percent).
`walls[]`	Every served wall, nearest first: `price`, `side` (short walls liquidate shorts above the mark, long walls liquidate longs below), `usd`, `distance_pct` (signed, 4 decimals), `distance_label`, `first_seen_ts`, `age_hours`.
`evidence`	`validated`: the level type passed the walk-forward validation gate. `measured`: its reach rate is measured but the type has not passed the gate. `unmeasured`: neither yet.
`reach_rate`, `reach_ci_low`, `reach_n`, `horizon`	How often price reached past levels like this one inside the horizon, its Wilson 95% lower bound and the sample count.
`truth.model`	Model version, grade, walk-forward hit share with its Wilson lower bound and sample count, measured-through date.
`record`	Links to the public record (`/proof`, `/api/v1/proof`).
`access`	Which access path served the call and the per-call price for the paid tier.

Cadence

Level snapshots are taken every 5 minutes for each covered coin.
A served response is at most 3 minutes older than its snapshot; as_of and age_sec say exactly.
Free keys read the snapshot from 2 hours earlier, on purpose.
Poll once a minute per coin at most; the snapshot does not change faster.

Coverage

Free: BTC, ETH, SOL, XRP, BNB and DOGE USDT perpetuals.
Paid tiers: the full covered list of USDT perpetuals at /api/v1/levels/symbols.

History depth

Version 1 serves the current snapshot only. There is no history endpoint yet.
The model is checked on a rolling walk-forward window of about 30 days; every response carries that window's sample count and Wilson lower bound in truth.model.
Snapshot history for backtests: ask [email protected].

Access and limits

Free key: sign in, then POST /api/keys/free. Delayed snapshot, Free coins, 60 calls per minute, metered per key per day.
Bot API key: $49 a month or $470 a year, Founding price locked for the first 50 subscribers. The current snapshot on every covered coin, 120 calls per minute, 100,000 calls per month. Start monthly or yearly.
Institutional key: the current snapshot on every covered coin, 120 calls per minute per key by default.
Pro session: the current snapshot in the browser and on this API.
Prepaid credits on any key: $10 for 600 calls, $50 for 3,500, $200 for 16,000. One credit per coin.
x402: no account, $0.005 per call in USDC on Base. The 402 response states the price.
Over a limit returns 429 with Retry-After and RateLimit-* headers.

The public record

Every level we publish goes on the record at hunterkiller.io/proof, misses included, with the sample size and a Wilson 95% lower bound on every figure.

What it is not

Modeled levels: prices where leveraged positions would be force closed, estimated from exchange open interest and liquidation history. Descriptive, not a forecast and not a trade instruction. Nothing here places an order.

Hunter Killer · Developer docs · Terms · Risk disclosure · Operated by Irishman Management LLC.