Free, no-auth, rate-limited JSON. No key, no signup. The same delayed liquidation tape and measured track record this site publishes, for integrations, research, and independent verification.
Use the free API for integrations, or open the visual Money Map to inspect the same liquidation context around price.
/api/public/coin_teaser/* and /coins/*) so the tracked
universe can't be cheaply enumerated.429 with {"error":"rate_limited"}
and a Retry-After: 60 header.Cache-Control: public. Cache them; the data
updates on its own schedule, not yours./api/public/liq_teaserGETLiquidation tape teaser (majors)
| Params | none |
|---|---|
| Response fields | ok, delayed_minutes, window_hours, generated_at, note; totals_24h{events, usd, long_usd, short_usd, largest_single_usd}; majors_24h[] per symbol (BTC/ETH/SOL/XRP); tape[]: last 40 delayed events ≥ $5k {ts, exchange, symbol, side, price, usd} |
| Notes | Cross-exchange liquidation tape, majors only, delayed 120 minutes. Descriptive history, not a forecast. 60s server cache. |
/api/public/coin_teaser/BTCUSDTGETPer-coin liquidation snapshot
| Params | path: {symbol}: any tracked perp symbol (e.g. BTCUSDT, ETHUSDT; the tracked universe is the /coins/* page set). Unknown symbols 404 (symbol_not_tracked); malformed symbols 404 (invalid_symbol). |
|---|---|
| Response fields | ok, symbol, delayed_minutes, window_hours, note, events_24h, usd_24h, long_usd_24h, short_usd_24h, largest_single_usd; tape[]: last 20 delayed events ≥ $5k {ts, exchange, side, price, usd} |
| Notes | Delayed 120 minutes on the free surface (the live free-tier delay, longer than the majors teaser). Stricter 60/min per-IP bucket (see rate limits). |
/api/desk_readGETDesk Read: five plain-word answers before a trade
| Params | query: symbol (default BTCUSDT); optional side (long or short), entry, leverage for your position (omit all three for a read of both hypothetical sides); optional ref (attribution tag); optional live=1 to be quoted the x402 per-call price for live data |
|---|---|
| Response fields | ok, symbol, as_of, price, pull, hurt, cascade, crowd, plan, hurt_reason, plan_reason, verdict (deprecated compatibility field: wall_in_band|no_wall_in_band|thin_data), verdict_side (long|short), bias (up|down|flat), verdict_reasons[], verdict_long{verdict, confidence, confidence_basis, reasons[]}, verdict_short{...}, verdict_other{...} (when a side is given), assumed_leverage, confidence (null until verdicts are scored), confidence_basis (unscored), flags{liq_distance_pct, wall_within_1pct, crowd_aligned}, stop_suggestion, target_suggestion, lines[], text, access{mode, live, delayed, price_usd_per_live_call}. Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, Cache-Control, X-HK-Data-Age-Seconds. Errors: 404 unknown_symbol {did_you_mean, symbols_url}, 422 invalid_number {field}, 403 symbol_requires_live_access {symbol, did_you_mean, symbols_url}. Age is unknown when no snapshot is available. RateLimit-Scope names the applied limiter, not-applied (zero values) for exemptions, or origin-snapshot for cached quota metadata; cached values are not a new per-visitor allowance. |
| Notes | Call before a trade. Pull: which side of the book holds more liquidation money. Hurt: where your liquidation sits and what is in the way. Cascade: how far a break would run. Crowd: who is paying funding. Plan: the nearest wall to lose at and the nearest to aim at. Free keyless calls get the delayed tier; an API key, a Pro session or an x402 payment gets live data. MCP tool: desk_read. Descriptive, not a forecast. The deprecated compatibility field verdict is wall_in_band, no_wall_in_band or thin_data, never null; proceed, reduce and skip are no longer emitted (contract change, SDK 0.4.1 docs). wall_in_band means the nearest wall on either side is under 1 percent from price, the same distance as flags.liq_distance_pct and the same test as flags.wall_within_1pct; thin_data means no price or no wall data. verdict_long and verdict_short apply that test to the losing-side wall (below for a long, above for a short) at the current price and assumed_leverage, or for your position. confidence is null with confidence_basis unscored until the public ledger scores verdicts. Compatibility metadata includes verdict_side, verdict_long, verdict_short, verdict_other, bias and confidence. The verdict, stop and target fields are deprecated compatibility fields, never advice. verdict is descriptive (wall_in_band, no_wall_in_band or thin_data) and reads the same wall set as the descriptive flags liq_distance_pct, wall_within_1pct and crowd_aligned, which replace it. stop_suggestion and target_suggestion mirror the deprecated plan and render on no customer surface. |
/api/desk_read/symbolsGETDesk Read: covered symbols per tier
| Params | none |
|---|---|
| Response fields | ok, free{symbols[], delay_sec, delay_minutes}, live{symbols[]}, covered[], cache_seconds |
| Notes | The symbols the Desk Read covers on the free delayed tier and the live tier, and the free-tier delay. Cached 5 minutes. Pass one of these as symbol to /api/desk_read. |
/proof/statsGETLive accuracy track record
| Params | none |
|---|---|
| Response fields | ok, generated_at, basis, random_baseline, window, headline, global, per-symbol governed blocks: every precision figure carries its sample size n and a Wilson 95% lower confidence bound (ci95_low / wilson_low) |
| Notes | Walk-forward, out-of-sample, de-overlapped. The same payload that powers the /proof page. 5-min server cache. |
/proof/evidenceGETFull accuracy evidence (download)
| Params | none |
|---|---|
| Response fields | ok, generated_at, what_this_is, verify_independently, ledger (complete published per-symbol accuracy ledger), headline_history (last 500 points) |
| Notes | The complete published track record as one machine-readable JSON (Content-Disposition: attachment). Includes auto-disabled symbols. Publishing what we switched off is the point. |
/proof/ledger.csvGETAccuracy ledger (CSV)
| Params | none |
|---|---|
| Response fields | symbol, n_windows, n_effective_samples, precision_at_n_mean, precision_at_n_weighted, wilson_low, random_baseline, lift_vs_random |
| Notes | The same per-symbol ledger as a spreadsheet-ready CSV. |
/proof/anchorsGETCryptographic anchor chain
| Params | none |
|---|---|
| Response fields | ok, chain_length, chain[] (daily anchors, most-recent first, max 90), hashed_files, how_to_verify, basis |
| Notes | Daily hash anchors over the proof artifacts. Verify the ledger's integrity independently. |
/proof/feed_trustGETFeed reconciliation verdicts
| Params | none |
|---|---|
| Response fields | ok, generated_at, window (rolling 7d), last_reconcile_run_ts, what_this_is, venues{} per venue {verdict, accuracy_pct, reconcile_accuracy_pct, coverage_pct, n_assessable, n_runs, ...} |
| Notes | We audit our OWN liquidation tape against independent exchange references and publish the verdicts, with the n shown. |
/feeds/trustGETTrust-scored venue feed
| Params | none |
|---|---|
| Response fields | ok, generated_at, window, as_of, venues_measured, venues_tracked, basis, venues[] per venue {verdict, n, Wilson ci95_low, trend, days_measured} |
| Notes | Per-venue reconciliation trust scores with the honest measured-vs-tracked venue count. 5-min server cache. |
/receipts.jsonGETMachine-readable receipts
| Params | none |
|---|---|
| Response fields | ok, as_of, as_of_iso, what_this_is, track_record, autopsy_index, feed_trust, methodology_links |
| Notes | The verifiable-evidence locker in one JSON: measured track record, published cascade autopsies, feed-trust audit. |
/healthzGETLiveness probe
| Params | none |
|---|---|
| Response fields | status |
| Notes | Public liveness probe used by external monitors. |
/.well-known/mcp.jsonGETMCP discovery document
| Params | none |
|---|---|
| Response fields | mcp: streamable-HTTP discovery for the /mcp agent-native server |
| Notes | Public https://hunterkiller.io/mcp: list_symbols and hk_levels need no key for six Free coins, 2 hours behind, using the same reader as /api/v1/levels/BTCUSDT. REST and these tools share 60 requests per minute and 500 per UTC day per IP. Storage fallback: 20 per minute with a process daily shadow, stated in headers. Protocol discovery and the public teasers remain keyless. Other data tools require a B2B API key (see /docs). |
Copy-paste; each returns JSON today.
curl -s https://hunterkiller.io/api/public/liq_teasercurl -s https://hunterkiller.io/api/public/coin_teaser/BTCUSDTcurl -s https://hunterkiller.io/proof/statsThree recipes, copy-paste runnable as-is against the live free endpoints, no key, no signup. Each is pinned in CI against the real payload shape, so what you copy is what runs.
import requests
r = requests.get("https://hunterkiller.io/api/public/liq_teaser", timeout=10)
r.raise_for_status()
d = r.json()
t = d["totals_24h"]
print(f"24h liquidations: ${t['usd']:,.0f} across {t['events']} events "
f"(tape delayed {d['delayed_minutes']} min)")
fetch("https://hunterkiller.io/api/public/coin_teaser/BTCUSDT")
.then((r) => r.json())
.then((d) => console.log(
`BTCUSDT 24h: $${Math.round(d.usd_24h).toLocaleString()} across `
+ `${d.events_24h} events (tape delayed ${d.delayed_minutes} min)`));
curl -s https://hunterkiller.io/api/public/liq_teaser
The live measured headline precision, with its sample size (n=…) and Wilson 95% lower bound, as a small auto-updating badge for your site. One iframe, no JavaScript SDK, no API key, no cookies. Attribution is built in; keep it intact.
<iframe src="https://hunterkiller.io/embed/accuracy" width="320" height="150" style="border:0;border-radius:10px" title="Measured liquidation-level accuracy, by Hunter Killer" loading="lazy"></iframe>The cross-venue funding snapshot (annualized mean, each figure with its venue count) and the Deribit gamma-flip level for BTC/ETH (each with its distance-from-spot and visible-strike count), with snapshot age on the face, descriptive-not-a-signal framing, and an honest unavailable state whenever a source is stale. One iframe, no API key, no cookies. Attribution is built in; keep it intact.
<iframe src="https://hunterkiller.io/embed/funding-gex" width="340" height="260" style="border:0;border-radius:10px" title="Cross-venue funding and dealer-gamma snapshot, by Hunter Killer" loading="lazy"></iframe>/api/v1/*, API-key
authenticated): real-time, full universe, metered.