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:

1 {
2   "id": "evt_example000000000000000001",
3   "type": "alert.triggered",
4   "version": "2026-05-08",
5   "api_version": "v1",
6   "livemode": true,
7   "created_at": "2026-01-15T12:00:00Z",
8   "data": {
9     "alert_id": "018f7a80-0000-7000-8000-000000000008",
10     "current_price": "0.72",
11     "direction": "above",
12     "market_id": "018f7a80-0000-7000-8000-000000000002",
13     "outcome_id": "018f7a80-0000-7000-8000-000000000003",
14     "target_price": "0.70"
15   },
16   "request_id": null,
17   "correlation_id": null
18 }

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.