Hunter KillerCreate free account
Menu

Public API

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.

The honesty contract. Liquidation tape endpoints are delayed 120 minutes. Real-time data and the full tracked universe live behind the dashboard and the paid B2B API (/docs). Every accuracy figure is a descriptive measurement of past performance with its sample size (n) and a Wilson 95% lower confidence bound. Never a forecast, never financial advice.
From JSON to a live market read

Use the free API for integrations, or open the visual Money Map to inspect the same liquidation context around price.

Rate limits

Endpoints

/api/public/liq_teaserGET

Liquidation tape teaser (majors)

Paramsnone
Response fieldsok, 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}
NotesCross-exchange liquidation tape, majors only, delayed 120 minutes. Descriptive history, not a forecast. 60s server cache.

/api/public/coin_teaser/BTCUSDTGET

Per-coin liquidation snapshot

Paramspath: {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 fieldsok, 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}
NotesDelayed 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_readGET

Desk Read: five plain-word answers before a trade

Paramsquery: 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 fieldsok, 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.
NotesCall 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/symbolsGET

Desk Read: covered symbols per tier

Paramsnone
Response fieldsok, free{symbols[], delay_sec, delay_minutes}, live{symbols[]}, covered[], cache_seconds
NotesThe 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/statsGET

Live accuracy track record

Paramsnone
Response fieldsok, 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)
NotesWalk-forward, out-of-sample, de-overlapped. The same payload that powers the /proof page. 5-min server cache.

/proof/evidenceGET

Full accuracy evidence (download)

Paramsnone
Response fieldsok, generated_at, what_this_is, verify_independently, ledger (complete published per-symbol accuracy ledger), headline_history (last 500 points)
NotesThe 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.csvGET

Accuracy ledger (CSV)

Paramsnone
Response fieldssymbol, n_windows, n_effective_samples, precision_at_n_mean, precision_at_n_weighted, wilson_low, random_baseline, lift_vs_random
NotesThe same per-symbol ledger as a spreadsheet-ready CSV.

/proof/anchorsGET

Cryptographic anchor chain

Paramsnone
Response fieldsok, chain_length, chain[] (daily anchors, most-recent first, max 90), hashed_files, how_to_verify, basis
NotesDaily hash anchors over the proof artifacts. Verify the ledger's integrity independently.

/proof/feed_trustGET

Feed reconciliation verdicts

Paramsnone
Response fieldsok, 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, ...}
NotesWe audit our OWN liquidation tape against independent exchange references and publish the verdicts, with the n shown.

/feeds/trustGET

Trust-scored venue feed

Paramsnone
Response fieldsok, generated_at, window, as_of, venues_measured, venues_tracked, basis, venues[] per venue {verdict, n, Wilson ci95_low, trend, days_measured}
NotesPer-venue reconciliation trust scores with the honest measured-vs-tracked venue count. 5-min server cache.

/receipts.jsonGET

Machine-readable receipts

Paramsnone
Response fieldsok, as_of, as_of_iso, what_this_is, track_record, autopsy_index, feed_trust, methodology_links
NotesThe verifiable-evidence locker in one JSON: measured track record, published cascade autopsies, feed-trust audit.

/healthzGET

Liveness probe

Paramsnone
Response fieldsstatus
NotesPublic liveness probe used by external monitors.

/.well-known/mcp.jsonGET

MCP discovery document

Paramsnone
Response fieldsmcp: streamable-HTTP discovery for the /mcp agent-native server
NotesPublic 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).

Examples

Copy-paste; each returns JSON today.

curl -s https://hunterkiller.io/api/public/liq_teaser
curl -s https://hunterkiller.io/api/public/coin_teaser/BTCUSDT
curl -s https://hunterkiller.io/proof/stats

Quickstart

Three 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.

Python requests

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)")

JavaScript fetch (browser or Node 18+)

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 any shell

curl -s https://hunterkiller.io/api/public/liq_teaser

Machine-readable docs

Embed the accuracy badge

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>

Embed the funding + gamma teaser

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>

More

Hunter Killer: liquidation intelligence with a published, measured track record. Data is delayed 120 minutes on the free surface; descriptive history, not a forecast. Terms · Risk disclosure