{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-webhook-event-descriptor-schema.json",
  "title": "WebhookEventDescriptor",
  "description": "Self-describing entry in the webhook event catalog: the event type a subscriber lists in event_types, when it fires, the data payload shape, and whether it currently fires (active) or is reserved (dormant, subscribable but not yet delivered). Pro-only event types (large_trades_inserted, whale_trades_inserted, wallet_grade_changed, suspicious_trade_flagged, insider_radar_flag_raised, sharp_money_flow_detected, smart_money_flow_detected) only deliver to API keys on an active Pro subscription. Export lifecycle event types (export_job_ready, export_job_failed, export_job_expired, export_job_cancelled) are owner-scoped to the API-key account that created the export and contain no download URL; use the authorized export status/download routes. Some entries are two spellings of one event: large_trades_inserted and whale_trades_inserted, trader_synced and whale_trader_synced, suspicious_trade_flagged and insider_radar_flag_raised, sharp_money_flow_detected and smart_money_flow_detected. Either spelling subscribes, and an endpoint receives deliveries under the spelling it registered. The deprecated spellings (whale_trades_inserted, whale_trader_synced, insider_radar_flag_raised, smart_money_flow_detected) reach their sunset on 2027-02-01 (#29352); register the canonical spelling.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/0xinsider-com-webhooks-api-openapi.yml#/components/schemas/WebhookEventDescriptor",
  "type": "object",
  "required": [
    "id",
    "description",
    "payload_shape",
    "status"
  ],
  "properties": {
    "id": {
      "$ref": "#/$defs/WebhookEventType"
    },
    "description": {
      "type": "string",
      "description": "One-line description of when the event fires."
    },
    "payload_shape": {
      "type": "string",
      "description": "Short description of the data payload object's shape."
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "dormant"
      ],
      "description": "active: the event has a firing producer callsite. dormant: advertised and subscribable, but does not yet enqueue any delivery."
    }
  },
  "$defs": {
    "WebhookEventType": {
      "type": "string",
      "enum": [
        "large_trade_inserted_v2",
        "large_trades_inserted",
        "whale_trades_inserted",
        "live_sports_updated",
        "trader_synced",
        "whale_trader_synced",
        "large_positions_updated",
        "wallet_grade_changed",
        "suspicious_trade_flagged",
        "insider_radar_flag_raised",
        "sharp_money_flow_detected",
        "smart_money_flow_detected",
        "export_job_ready",
        "export_job_failed",
        "export_job_expired",
        "export_job_cancelled"
      ]
    }
  }
}