Skip to main content
Event: oracle_events
Cost: 0.1 credits per delivery
Fires on on-chain oracle activity — resolution, dispute, assertion, emergency, and related event types. The full payload schema is in the auto-generated Oracle Events callback reference; this page documents the filters and matching behavior.

​
When to use this

  • Track market resolutions and settle positions as soon as the oracle reports.
  • Get alerted to disputes or emergency actions that may affect open markets.
  • Monitor assertion lifecycle activity for specific conditions you care about.

​
Subscription filters

Add these to the filters object when you create the subscription.
FilterTypeDescription
oracle_event_typesstring[]Restrict to specific oracle event types, e.g. QuestionResolved, DisputePrice, ProposePrice (max 500).
condition_idsstring[]Restrict to specific markets by condition ID (max 500).

​
Example

{
  "url": "https://your-server.com/webhooks",
  "event": "oracle_events",
  "filters": {
    "oracle_event_types": ["QuestionResolved", "DisputePrice"]
  }
}

​
Notes

  • oracle_event_types narrows delivery to specific lifecycle events — set it to receive only the stages you care about (e.g. just QuestionResolved) instead of every oracle action.
Last modified on June 3, 2026