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.

Rate limits

• 600 requests/minute per IP across all endpoints (global limiter).
• 60 requests/minute per IP additionally on the per-coin surface (/api/public/coin_teaser/* and /coins/*) so the tracked universe can't be cheaply enumerated.
• Over the limit → 429 with {"error":"rate_limited"} and a Retry-After: 60 header.
• Responses carry Cache-Control: public — cache them; the data updates on its own schedule, not yours.

Endpoints

Examples

Copy-paste; each returns JSON today.

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

• /developers/openapi.json — OpenAPI 3.0 spec for every endpoint on this page, generated from the same registry, rate limits included in each operation.
• /developers/postman_collection.json — Postman v2.1 collection, one request per endpoint; import and run.

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.

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) — 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.

More

• /covered — "is my coin covered?" one lookup: coin page, predicted levels, free-surface status, or the honest not-yet.
• /proof — the human-readable track record these numbers power.
• /methodology — the frozen metric contract every figure follows.
• /docs — the paid B2B Data API (/api/v1/*, API-key authenticated): real-time, full universe, metered.
• /llms.txt — agent-native discovery document.