Event catalog

trade.executed

A trade prints against your order.

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.

FieldTypeRequired
market_idstring (uuid)Yes
outcome_idstring (uuid)Yes
pricenumber or stringYes
quantitynumber or stringYes
rolestring · nullableNo
total_valuenumber or stringYes
trade_idstring (uuid)Yes

Example delivery

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

1{
2  "id": "evt_example000000000000000001",
3  "type": "trade.executed",
4  "version": "2026-05-08",
5  "api_version": "v1",
6  "livemode": true,
7  "created_at": "2026-01-15T12:00:00Z",
8  "data": {
9    "market_id": "018f7a80-0000-7000-8000-000000000002",
10    "outcome_id": "018f7a80-0000-7000-8000-000000000003",
11    "price": "0.62",
12    "quantity": "10.00",
13    "role": "TAKER",
14    "total_value": "6.20",
15    "trade_id": "018f7a80-0000-7000-8000-000000000004"
16  },
17  "request_id": null,
18  "correlation_id": null
19}

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.