> ## Documentation Index
> Fetch the complete documentation index at: https://docs.struct.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Oracle Events

> Fires on on-chain oracle activity — resolution, dispute, assertion, emergency, and related event types.

<Note>
  **Event:** `oracle_events` \
  **Cost:** 0.1 credits per delivery
</Note>

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](/api-reference/webhook-callbacks/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.

| Filter               | Type      | Description                                                                                                 |
| -------------------- | --------- | ----------------------------------------------------------------------------------------------------------- |
| `oracle_event_types` | string\[] | Restrict to specific oracle event types, e.g. `QuestionResolved`, `DisputePrice`, `ProposePrice` (max 500). |
| `condition_ids`      | string\[] | Restrict to specific markets by condition ID (max 500).                                                     |

## Example

```json theme={null}
{
  "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.