Webhooks

Signed HTTPS POST callbacks when the managed pipeline completes or notable signals fire. Configure endpoints in the app under Settings → API keys.

Register endpoints in the app (POST /api/api-webhooks with your session cookie) or from Settings → API keys after approval.

Events

• daily_snapshot: Fires after each completed managed UTC run.
• breakout_threshold: Coins with breakout_score ≥ 80 on the latest day.
• whale_signal: Fresh whale interpretation rows from the latest window.
• catalyst_change: Catalyst label changed vs the prior UTC day.

Signature headers

• X-Kvantrank-Event: Event type (for example daily_snapshot).
• X-Kvantrank-Signature: t=<unix>,v1=<hmac_sha256_hex> over "<t>.<raw_json_body>" using your whsec_ signing secret.

Example payload

{
  "id": "evt_…",
  "type": "daily_snapshot",
  "created_at": "2026-06-16T12:00:00.000Z",
  "data": { "date_utc": "2026-06-16", "run_owner": "managed" }
}

Verify by recomputing HMAC-SHA256 over {timestamp}.{raw_body} with your whsec_… signing secret.