reward.earned

A reward configuration changes for your market.

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
amountnumber or string · nullableNo
market_idstring (uuid) · nullableNo
reward_idstring (uuid) · nullableNo
reward_typestring · nullableNo
statusstring · nullableNo

Example delivery

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

{
"id": "evt_example000000000000000001",
"type": "reward.earned",
"version": "2026-05-08",
"api_version": "v1",
"livemode": true,
"created_at": "2026-01-15T12:00:00Z",
"data": {
"amount": "5.00",
"market_id": "018f7a80-0000-7000-8000-000000000002",
"reward_id": "018f7a80-0000-7000-8000-000000000007",
"reward_type": "MARKET_CREATOR",
"status": "EARNED"
},
"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.