> ## Documentation Index > Fetch the complete documentation index at: https://docs.agg.market/llms.txt > Use this file to discover all available pages before exploring further. # User events > User-specific events (requires user-level auth via authenticate action or token query param). Streams order confirmations, balance updates, and a venue-agnostic order lifecycle event (`order_event`) covering DAG steps and terminal fill / failure status across all venues. ## AsyncAPI ````yaml openapi/asyncapi.json userEvents id: userEvents title: User events description: >- User-specific events (requires user-level auth via authenticate action or token query param). Streams order confirmations, balance updates, and a venue-agnostic order lifecycle event (`order_event`) covering DAG steps and terminal fill / failure status across all venues. servers: - id: production protocol: wss host: ws.agg.market bindings: [] variables: [] address: / parameters: [] bindings: [] operations: - &ref_1 id: receiveOrderSubmitted title: Receive order submitted description: Order confirmation after trade execution (user-level auth required) type: receive messages: - &ref_4 id: orderSubmitted payload: - name: Order submitted description: >- Order confirmation after trade execution (user-level auth required) type: object properties: - name: type type: string description: order_submitted required: true - name: venue type: string required: true - name: orderId type: string required: true - name: side type: string required: true - name: price type: number required: true - name: size type: number required: true - name: outcomeId type: string required: false - name: timestamp type: number required: true headers: [] jsonPayloadSchema: title: OrderSubmitted type: object required: - type - venue - orderId - side - price - size - timestamp properties: type: const: order_submitted type: string x-parser-schema-id: venue: type: string x-parser-schema-id: orderId: type: string x-parser-schema-id: side: type: string x-parser-schema-id: price: type: number x-parser-schema-id: size: type: number x-parser-schema-id: outcomeId: type: string x-parser-schema-id: timestamp: type: number x-parser-schema-id: x-parser-schema-id: title: Order submitted description: Order confirmation after trade execution (user-level auth required) example: |- { "type": "order_submitted", "venue": "polymarket", "orderId": "ord_abc123", "side": "buy", "price": 0.55, "size": 100, "outcomeId": "clv2abc123def456", "timestamp": 1710000000000 } bindings: [] extensions: - id: x-parser-unique-object-id value: orderSubmitted bindings: [] extensions: &ref_0 - id: x-parser-unique-object-id value: userEvents - &ref_2 id: receiveBalanceUpdate title: Receive balance update description: Balance update after trade execution (user-level auth required) type: receive messages: - &ref_5 id: balanceUpdate payload: - name: Balance update description: Balance update after execution (user-level auth required) type: object properties: - name: type type: string description: balance_update required: true - name: venue type: string required: true - name: tradingBalanceCents type: number required: true - name: walletBalanceCents type: number required: false - name: timestamp type: number required: true headers: [] jsonPayloadSchema: title: BalanceUpdate type: object required: - type - venue - tradingBalanceCents - timestamp properties: type: const: balance_update type: string x-parser-schema-id: venue: type: string x-parser-schema-id: tradingBalanceCents: type: number x-parser-schema-id: walletBalanceCents: type: number x-parser-schema-id: timestamp: type: number x-parser-schema-id: x-parser-schema-id: title: Balance update description: Balance update after execution (user-level auth required) example: |- { "type": "balance_update", "venue": "polymarket", "tradingBalanceCents": 94500, "walletBalanceCents": 100000, "timestamp": 1710000000000 } bindings: [] extensions: - id: x-parser-unique-object-id value: balanceUpdate bindings: [] extensions: *ref_0 - &ref_3 id: receiveOrderEvent title: Receive order event description: Venue-agnostic order lifecycle event (user-level auth required) type: receive messages: - &ref_6 id: orderEvent payload: - name: Order lifecycle event description: >- Venue-agnostic DAG and order lifecycle stream. Discriminate on the `event` field. Emitted for every venue automatically. type: object properties: - name: type type: string description: order_event required: true - name: event type: string required: true - name: userId type: string required: true - name: orderId type: string required: true - name: venue type: string required: false - name: filledAmountRaw type: string required: false - name: remainingAmountRaw type: string required: false - name: errorReason type: string required: false - name: dagRunId type: string required: false - name: stepId type: string required: false - name: stepType type: string required: false - name: templateName type: string required: false - name: attempt type: number required: false - name: timestamp type: number required: true headers: [] jsonPayloadSchema: title: OrderEvent type: object required: - type - event - userId - orderId - timestamp properties: type: const: order_event type: string x-parser-schema-id: event: anyOf: - const: dag_started type: string x-parser-schema-id: - const: dag_completed type: string x-parser-schema-id: - const: dag_failed type: string x-parser-schema-id: - const: dag_cancelled type: string x-parser-schema-id: - const: step_started type: string x-parser-schema-id: - const: step_completed type: string x-parser-schema-id: - const: step_waiting type: string x-parser-schema-id: - const: step_failed type: string x-parser-schema-id: - const: step_retrying type: string x-parser-schema-id: - const: filled type: string x-parser-schema-id: - const: partial_fill type: string x-parser-schema-id: - const: failed type: string x-parser-schema-id: x-parser-schema-id: userId: type: string x-parser-schema-id: orderId: type: string x-parser-schema-id: venue: type: string x-parser-schema-id: filledAmountRaw: type: string x-parser-schema-id: remainingAmountRaw: type: string x-parser-schema-id: errorReason: type: string x-parser-schema-id: dagRunId: type: string x-parser-schema-id: stepId: type: string x-parser-schema-id: stepType: type: string x-parser-schema-id: templateName: type: string x-parser-schema-id: attempt: type: number x-parser-schema-id: timestamp: type: number x-parser-schema-id: x-parser-schema-id: title: Order lifecycle event description: >- Venue-agnostic DAG and order lifecycle stream. Discriminate on the `event` field. Emitted for every venue automatically. example: |- { "type": "order_event", "event": "dag_started", "userId": "usr_xyz789", "orderId": "ord_abc123", "venue": "polymarket", "filledAmountRaw": "string", "remainingAmountRaw": "string", "errorReason": "string", "dagRunId": "string", "stepId": "string", "stepType": "string", "templateName": "string", "attempt": 0, "timestamp": 1710000000000 } bindings: [] extensions: - id: x-parser-unique-object-id value: orderEvent bindings: [] extensions: *ref_0 sendOperations: - *ref_1 - *ref_2 - *ref_3 receiveOperations: [] sendMessages: - *ref_4 - *ref_5 - *ref_6 receiveMessages: [] extensions: - id: x-parser-unique-object-id value: userEvents securitySchemes: - id: appId name: appId type: userPassword description: >- App-level auth: pass appId as a query parameter on connect. Required for all connections. The appId must belong to an active app with matching allowed origins. extensions: [] - id: jwt name: jwt type: http description: >- User-level auth: pass JWT as token query param on connect, or send { action: 'authenticate', token } mid-session. Required for user-specific events (orders, balances). Same JWT as the REST API. scheme: bearer bearerFormat: JWT extensions: [] ````