Oracle Events

Event: oracle_events
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.1 credits per event

Fires on every on-chain oracle event affecting a Polymarket market. Use oracle_event_types to restrict to specific kinds, and condition_ids to narrow by market. The data payload is a discriminated union keyed on event_type.

Filters

Filter	Type	Required	Description
`oracle_event_types`	`string[]`	No	Restrict to specific event types (see list below)
`condition_ids`	`string[]`	No	Restrict to specific markets

Event types

Valid values for oracle_event_types: AssertionMade, AssertionDisputed, AssertionSettled, RequestPrice, ProposePrice, DisputePrice, Settle, QuestionResolved, QuestionEmergencyResolved, QuestionReset, QuestionInitialized, QuestionPaused, QuestionUnpaused, QuestionFlagged, QuestionUnflagged, ConditionResolution, NegRiskOutcomeReported.

{
  "op": "subscribe",
  "event": "oracle_events",
  "oracle_event_types": ["QuestionResolved", "ConditionResolution"],
  "condition_ids": ["0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b"]
}

Response

The data object is a discriminated union keyed on event_type. The QuestionResolved variant is shown below; full schemas for every variant are documented on the Oracle Events room page.

{
  "event": "oracle_events",
  "timestamp": 1743500000000,
  "data": {
    "event_type": "QuestionResolved",
    "id": "0xresolved123",
    "hash": "0xresolvedhash",
    "block": 65001400,
    "confirmed_at": 1743501400,
    "log_index": 2,
    "block_index": 0,
    "oracle_contract": "0x157Ce2d672854c848c9b79C49a8Cc6cc89176a49",
    "condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
    "settled_price": 1000000000000000000,
    "proposed_outcome": "Yes"
  }
}

Last modified on April 25, 2026

Market Created

Market Resolved

Introduction

Rooms

Alerts

Filters

Event types

Response

​Filters

​Event types

​Subscribe

​Response

Filters

Event types

Subscribe

Response