Webhook Event Types

Events

HEURISTICS_COMPLETE

Fired when async heuristic analysis (full screening mode) completes.

{
  "type": "HEURISTICS_COMPLETE",
  "data": {
    "address": "0xd8dA...",
    "chain": "ethereum",
    "job_id": "job_xyz789",
    "risk_score": 12,
    "risk_level": "LOW",
    "flags": [],
    "completed_at": "2026-04-04T14:30:15Z"
  }
}

SANCTIONS_LIST_UPDATED

Fired when a sanctions list is refreshed (every 6 hours).

{
  "type": "SANCTIONS_LIST_UPDATED",
  "data": {
    "list": "OFAC_SDN",
    "additions": 3,
    "removals": 1,
    "total_entries": 2847,
    "effective_date": "2026-04-04"
  }
}

CREDIT_THRESHOLD

Fired when your monthly credit usage crosses 80% or 90%.

{
  "type": "CREDIT_THRESHOLD",
  "data": {
    "threshold": 80,
    "credits_used": 8042,
    "credit_limit": 10000,
    "reset_date": "2026-05-01"
  }
}

Retry logic

If your endpoint returns a non-2xx status or times out (30 second timeout):

Attempt	Delay
1st retry	30 seconds
2nd retry	2 minutes
3rd retry	15 minutes
4th retry	1 hour
5th retry	4 hours

After 5 failed retries, the event is marked as failed. Failed events can be replayed from the dashboard.