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
`market_id`	string (uuid)	Yes
`outcome_id`	string (uuid)	Yes
`price`	number or string	Yes
`quantity`	number or string	Yes
`role`	string · nullable	No
`total_value`	number or string	Yes
`trade_id`	string (uuid)	Yes

Example delivery

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

{
  "id": "evt_example000000000000000001",
  "type": "trade.executed",
  "version": "2026-05-08",
  "api_version": "v1",
  "livemode": true,
  "created_at": "2026-01-15T12:00:00Z",
  "data": {
    "market_id": "018f7a80-0000-7000-8000-000000000002",
    "outcome_id": "018f7a80-0000-7000-8000-000000000003",
    "price": "0.62",
    "quantity": "10.00",
    "role": "TAKER",
    "total_value": "6.20",
    "trade_id": "018f7a80-0000-7000-8000-000000000004"
  },
  "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.