Drazill API Documentation

Event schema version 2026-05-08. Delivered as the type field of the webhook envelope, signed with Drazill-Webhook-Signature.

Payload fields

The data object carries these fields. Money and quantity values are delivered as decimal strings. Fields beyond the structural IDs are optional because a producer legitimately omits them on some transitions.

Field	Type	Required
`alert_id`	string (uuid)	Yes
`alert_type`	string · nullable	No
`band_high`	number or string · nullable	No
`band_low`	number or string · nullable	No
`current_price`	number or string · nullable	No
`direction`	string · nullable	No
`market_id`	string (uuid)	Yes
`move_pp`	number or string · nullable	No
`outcome_id`	string (uuid) · nullable	No
`target_price`	number or string · nullable	No
`threshold`	number or string · nullable	No
`volume`	number or string · nullable	No
`window_minutes`	integer · nullable	No

Example delivery

The full request body — the envelope wrapping this event’s data:

{
  "id": "evt_example000000000000000001",
  "type": "alert.triggered",
  "version": "2026-05-08",
  "api_version": "v1",
  "livemode": true,
  "created_at": "2026-01-15T12:00:00Z",
  "data": {
    "alert_id": "018f7a80-0000-7000-8000-000000000008",
    "current_price": "0.72",
    "direction": "above",
    "market_id": "018f7a80-0000-7000-8000-000000000002",
    "outcome_id": "018f7a80-0000-7000-8000-000000000003",
    "target_price": "0.70"
  },
  "request_id": null,
  "correlation_id": null
}

Verify the signature before you act on a webhook, and treat it as a notification: re-read authoritative state from the REST API before moving money. See Signing & verification.