Webhooks Overview

Webhooks deliver real-time notifications to your server when events occur, eliminating the need for polling.

Event types

Event	Description
HEURISTICS_COMPLETE	Async heuristic analysis finished for a screening request
SANCTIONS_LIST_UPDATED	A sanctions list has been refreshed
CHAIN_STATUS_CHANGED	A chain's indexing status changed (e.g., synced → degraded)
CREDIT_THRESHOLD	Your credit usage crossed 80% or 90% of monthly limit

How it works

1. Configure a webhook URL in your developer dashboard
2. CryptaChain sends an HTTP POST to your URL when events occur
3. Your server responds with 200 OK to acknowledge receipt
4. If delivery fails, we retry with exponential backoff (see Retry Logic)

Payload format

{
  "id": "evt_abc123",
  "type": "HEURISTICS_COMPLETE",
  "timestamp": "2026-04-04T14:30:00Z",
  "data": {
    "address": "0xd8dA...",
    "chain": "ethereum",
    "risk_score": 12,
    "risk_level": "LOW",
    "job_id": "job_xyz789"
  },
  "signature": "sha256=abc123..."
}

Every payload includes an HMAC-SHA256 signature in the X-CryptaChain-Signature header. Always verify this signature before processing the event.

Verify signatures →