> ## Documentation Index > Fetch the complete documentation index at: https://docs.predexon.com/llms.txt > Use this file to discover all available pages before exploring further. # Oracle Playground > UMA oracle resolution events — proposals, disputes, settlements, and resets. ## AsyncAPI ````yaml websocket/asyncapi.json oracle id: oracle title: Oracle description: UMA oracle resolution events — proposals, disputes, settlements, and resets. servers: - id: production protocol: wss host: wss.predexon.com bindings: [] variables: [] address: / parameters: [] bindings: [] operations: - &ref_1 id: sendSubscribeOracle title: Send subscribe oracle type: receive messages: - &ref_6 id: SubscribeOracle payload: - name: Subscribe to Oracle description: condition_ids or market_slugs only. No users filter. type: object properties: - name: action type: string description: Must be 'subscribe' required: true - name: platform type: string description: Must be 'polymarket' required: true - name: version type: integer description: Must be 1 required: true - name: type type: string description: Must be 'oracle' required: true - name: filters type: object required: true properties: - name: condition_ids type: array description: Market condition IDs or ["*"] required: false properties: - name: item type: string required: false - name: market_slugs type: array description: Market URL slugs required: false properties: - name: item type: string required: false headers: [] jsonPayloadSchema: type: object required: - action - platform - version - type - filters properties: action: type: string description: Must be 'subscribe' x-parser-schema-id: platform: type: string description: Must be 'polymarket' x-parser-schema-id: version: type: integer description: Must be 1 x-parser-schema-id: type: type: string description: Must be 'oracle' x-parser-schema-id: filters: type: object properties: condition_ids: type: array description: Market condition IDs or ["*"] items: type: string x-parser-schema-id: x-parser-schema-id: market_slugs: type: array description: Market URL slugs items: type: string x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: examples: - action: subscribe platform: polymarket version: 1 type: oracle filters: condition_ids: - '*' x-parser-schema-id: title: Subscribe to Oracle description: condition_ids or market_slugs only. No users filter. example: |- { "action": "subscribe", "platform": "polymarket", "version": 1, "type": "oracle", "filters": { "condition_ids": [ "*" ] } } bindings: [] extensions: - id: x-parser-unique-object-id value: SubscribeOracle - id: x-parser-message-name value: SubscribeOracle bindings: [] extensions: &ref_0 - id: x-mint value: &ref_11 content: >- WebSocket requires a **Dev** or **Pro** API key. Free tier keys cannot connect. [Get your key →](https://dashboard.predexon.com) - id: x-parser-unique-object-id value: oracle - &ref_2 id: sendUnsubscribeOracle title: Send unsubscribe oracle type: receive messages: - &ref_7 id: Unsubscribe payload: - name: Unsubscribe description: Remove a subscription by ID. type: object properties: - name: action type: string description: Must be 'unsubscribe' required: true - name: subscription_id type: string description: Subscription ID from the ack response (e.g. sub_2f4b15b33798) required: true headers: [] jsonPayloadSchema: type: object required: - action - subscription_id properties: action: type: string description: Must be 'unsubscribe' x-parser-schema-id: subscription_id: type: string description: Subscription ID from the ack response (e.g. sub_2f4b15b33798) x-parser-schema-id: examples: - action: unsubscribe subscription_id: sub_2f4b15b33798 x-parser-schema-id: title: Unsubscribe description: Remove a subscription by ID. example: |- { "action": "unsubscribe", "subscription_id": "sub_2f4b15b33798" } bindings: [] extensions: - id: x-parser-unique-object-id value: Unsubscribe - id: x-parser-message-name value: Unsubscribe bindings: [] extensions: *ref_0 - &ref_3 id: sendUpdateOracle title: Send update oracle type: receive messages: - &ref_8 id: Update payload: - name: Update Subscription description: >- Replace filters on an existing subscription. Not supported on the orderbook channel. type: object properties: - name: action type: string description: Must be 'update' required: true - name: subscription_id type: string description: Subscription ID to update required: true - name: filters type: object description: New filters (replaces existing filters entirely) required: true properties: - name: users type: array description: Wallet addresses required: false properties: - name: item type: string required: false - name: condition_ids type: array description: Market condition IDs required: false properties: - name: item type: string required: false - name: market_slugs type: array description: Market URL slugs required: false properties: - name: item type: string required: false - name: status type: string description: confirmed, pending, or all (orders channel only) enumValues: - confirmed - pending - all required: false - name: token_ids type: array description: CLOB token IDs (orderbook channel only) required: false properties: - name: item type: string required: false - name: feeds type: array description: Chainlink crypto feed symbols (crypto_prices channel only) required: false properties: - name: item type: string required: false headers: [] jsonPayloadSchema: type: object required: - action - subscription_id - filters properties: action: type: string description: Must be 'update' x-parser-schema-id: subscription_id: type: string description: Subscription ID to update x-parser-schema-id: filters: type: object description: New filters (replaces existing filters entirely) properties: users: type: array description: Wallet addresses items: type: string x-parser-schema-id: x-parser-schema-id: condition_ids: type: array description: Market condition IDs items: type: string x-parser-schema-id: x-parser-schema-id: market_slugs: type: array description: Market URL slugs items: type: string x-parser-schema-id: x-parser-schema-id: status: type: string description: confirmed, pending, or all (orders channel only) enum: - confirmed - pending - all x-parser-schema-id: token_ids: type: array description: CLOB token IDs (orderbook channel only) items: type: string x-parser-schema-id: x-parser-schema-id: feeds: type: array description: Chainlink crypto feed symbols (crypto_prices channel only) items: type: string x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: examples: - action: update subscription_id: sub_2f4b15b33798 filters: users: - 0xnew_address... status: all x-parser-schema-id: title: Update Subscription description: >- Replace filters on an existing subscription. Not supported on the orderbook channel. example: |- { "action": "update", "subscription_id": "sub_2f4b15b33798", "filters": { "users": [ "0xnew_address..." ], "status": "all" } } bindings: [] extensions: - id: x-parser-unique-object-id value: Update - id: x-parser-message-name value: Update bindings: [] extensions: *ref_0 - &ref_4 id: receiveAckOracle title: Receive ack oracle type: send messages: - &ref_9 id: Ack payload: - name: Acknowledgement description: >- Server acknowledgement for subscribe, unsubscribe, and update actions. type: object properties: - name: type type: string description: ack required: true - name: subscription_id type: string description: The subscription ID required: true - name: channel type: string description: >- Channel name (trades, activity, lifecycle, orderbook, oracle, collateral, crypto_prices) required: true headers: [] jsonPayloadSchema: type: object properties: type: type: string description: ack x-parser-schema-id: subscription_id: type: string description: The subscription ID x-parser-schema-id: channel: type: string description: >- Channel name (trades, activity, lifecycle, orderbook, oracle, collateral, crypto_prices) x-parser-schema-id: required: - type - subscription_id - channel examples: - type: ack subscription_id: sub_2f4b15b33798 channel: trades x-parser-schema-id: title: Acknowledgement description: Server acknowledgement for subscribe, unsubscribe, and update actions. example: |- { "type": "ack", "subscription_id": "sub_2f4b15b33798", "channel": "trades" } bindings: [] extensions: - id: x-parser-unique-object-id value: Ack - id: x-parser-message-name value: Ack bindings: [] extensions: *ref_0 - &ref_5 id: receiveOracleEvent title: Receive oracle event type: send messages: - &ref_10 id: OracleEvent payload: - name: Oracle Event description: UMA oracle resolution event. type: object properties: - name: event_type type: string description: Event type enumValues: - proposal - dispute - settled - reset required: true - name: condition_id type: string description: Market condition ID required: true - name: question_id type: string description: UMA question ID required: false - name: market_id type: string description: Polymarket market ID required: false - name: title type: string description: Market title required: false - name: market_slug type: string description: Market URL slug required: false - name: image type: string description: Market image URL required: false - name: outcomes type: array description: Outcome labels required: false properties: - name: item type: string required: false - name: tokens type: array description: Tokens [{token_id, label}] required: false properties: - name: token_id type: string required: false - name: label type: string required: false - name: is_neg_risk type: boolean description: Whether neg-risk framework required: false - name: proposer type: string description: Proposer address required: false - name: disputer type: string description: Disputer address required: false - name: proposed_price type: string description: 1 = Yes, 0 = No required: false - name: settled_price type: string description: Final resolved outcome required: false - name: expiration_timestamp type: integer description: Liveness window end (Unix s) required: false - name: payout type: string description: Bond payout amount required: false - name: request_timestamp type: integer description: Original request time (Unix s) required: false - name: tx_hash type: string description: Transaction hash required: true - name: log_index type: string description: Log index (hex) required: false - name: block_number type: string description: Block number (hex) required: false - name: timestamp type: integer description: Unix timestamp in seconds required: true headers: [] jsonPayloadSchema: type: object properties: event_type: type: string description: Event type enum: - proposal - dispute - settled - reset x-parser-schema-id: condition_id: type: string description: Market condition ID x-parser-schema-id: question_id: type: string description: UMA question ID x-parser-schema-id: market_id: type: string description: Polymarket market ID x-parser-schema-id: title: type: string description: Market title x-parser-schema-id: market_slug: type: string description: Market URL slug x-parser-schema-id: image: type: string description: Market image URL x-parser-schema-id: outcomes: type: array description: Outcome labels items: type: string x-parser-schema-id: x-parser-schema-id: tokens: type: array description: Tokens [{token_id, label}] items: type: object properties: token_id: type: string x-parser-schema-id: label: type: string x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: is_neg_risk: type: boolean description: Whether neg-risk framework x-parser-schema-id: proposer: type: string description: Proposer address x-parser-schema-id: disputer: type: string description: Disputer address x-parser-schema-id: proposed_price: type: string description: 1 = Yes, 0 = No x-parser-schema-id: settled_price: type: string description: Final resolved outcome x-parser-schema-id: expiration_timestamp: type: integer description: Liveness window end (Unix s) x-parser-schema-id: payout: type: string description: Bond payout amount x-parser-schema-id: request_timestamp: type: integer description: Original request time (Unix s) x-parser-schema-id: tx_hash: type: string description: Transaction hash x-parser-schema-id: log_index: type: string description: Log index (hex) x-parser-schema-id: block_number: type: string description: Block number (hex) x-parser-schema-id: timestamp: type: integer description: Unix timestamp in seconds x-parser-schema-id: required: - event_type - condition_id - tx_hash - timestamp examples: - event_type: proposal condition_id: 0x4c57... market_id: '123456' title: Will X happen by April 7? market_slug: will-x-happen-by-april-7 outcomes: - 'Yes' - 'No' tokens: - token_id: 82855... label: 'Yes' - token_id: 55194... label: 'No' is_neg_risk: false proposer: 0xabc... proposed_price: '1' expiration_timestamp: 1775204004 request_timestamp: 1775196804 timestamp: 1775196804 x-parser-schema-id: title: Oracle Event description: UMA oracle resolution event. example: |- { "event_type": "proposal", "condition_id": "0x4c57...", "market_id": "123456", "title": "Will X happen by April 7?", "market_slug": "will-x-happen-by-april-7", "outcomes": [ "Yes", "No" ], "tokens": [ { "token_id": "82855...", "label": "Yes" }, { "token_id": "55194...", "label": "No" } ], "is_neg_risk": false, "proposer": "0xabc...", "proposed_price": "1", "expiration_timestamp": 1775204004, "request_timestamp": 1775196804, "timestamp": 1775196804 } bindings: [] extensions: - id: x-parser-unique-object-id value: OracleEvent - id: x-parser-message-name value: OracleEvent bindings: [] extensions: *ref_0 sendOperations: - *ref_1 - *ref_2 - *ref_3 receiveOperations: - *ref_4 - *ref_5 sendMessages: - *ref_6 - *ref_7 - *ref_8 receiveMessages: - *ref_9 - *ref_10 extensions: - id: x-mint value: *ref_11 - id: x-parser-unique-object-id value: oracle securitySchemes: - id: apiKey name: api_key type: httpApiKey description: Your Predexon API key in: query extensions: [] ````