Combo Status Update Event

combo_status_update is emitted after a combo transaction is mined. Match its tx_hash to a pending combo_execution; then use confirmed_fills[] as the on-chain result. The fill rows use the same maker-perspective schema as combo_execution.data.trades[]: size is shares, amount_usdc is dollars, and price is the actual execution price. Receipt-only lifecycle activity can appear in lifecycle_events[] even when PolyNode did not observe a pending transaction. This includes combo-native AutoRedeemer activity. Standard redemption subscribers continue to receive the corresponding stable redemption event where applicable.

Example

{
  "type": "combo_status_update",
  "timestamp": 1785812123000,
  "data": {
    "event_type": "combo_status_update",
    "tx_hash": "0xf4f973bcca17c05081574c36183a5f61fae8eb5895a2d46d71aaadb3cf11e556",
    "block_number": 91404731,
    "confirmed_at": 1785812123000,
    "execution_status": "CONFIRMED",
    "pending_detected_at": 1785812120366,
    "latency_ms": 2634,
    "combo_condition_id": "0x03af499212591cdbfd21ab04df07b8fb720000000000000000000000000000",
    "yes_position_id": "1666644547653825639538654505467109608411697937035881104213580452779446501376",
    "no_position_id": "1666644547653825639538654505467109608411697937035881104213580452779446501377",
    "order_hashes": [
      "0x9fd9da991a3d8f82bfb13e2901422a1621d87db1e27ce4da33fd5a61dec4f4b7",
      "0x1eb1c486ccad5622329d3e88147c6e98698521ebff86fcbd27ab7efa7fd458d5"
    ],
    "legs": [
      {
        "position_id": "759456036058902166074175781780133450895503656129754990757956704995918217217",
        "condition_id": "0x01add63e0052d10828c47551c3e231dedd0000000000000000000000000000",
        "module_id": 1,
        "module_name": "BinaryModule",
        "outcome_index": 1,
        "leg_outcome_label": "No",
        "market": {
          "title": "Phoenix Mercury vs. Chicago Sky",
          "slug": "wnba-phx-chi-2026-08-03",
          "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/wnba-logo-PAR4befDAubM.png",
          "event_title": "Phoenix Mercury vs. Chicago Sky",
          "event_slug": "wnba-phx-chi-2026-08-03",
          "outcomes": ["Phoenix Mercury", "Chicago Sky"],
          "token_ids": [
            "74953064150171307888139369905607115013164923361328779028892093225372812178760",
            "103031736784837797872355003049421848467848734930275080911268726099634278504076"
          ]
        }
      },
      {
        "position_id": "888399010527256025342625662713948815643754849506664777044908366823210090496",
        "condition_id": "0x01f6d0e6bdba3f8d15dc0928842624b9f10000000000000000000000000000",
        "module_id": 1,
        "module_name": "BinaryModule",
        "outcome_index": 0,
        "leg_outcome_label": "Yes",
        "market": {
          "title": "National Bank Open: Tatjana Maria vs Caty McNally",
          "slug": "wta-maria-mcnally-2026-08-03",
          "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/wta-logo-41f331bdf1.png",
          "event_title": "National Bank Open: Tatjana Maria vs Caty McNally",
          "event_slug": "wta-maria-mcnally-2026-08-03",
          "outcomes": ["Tatjana Maria", "Caty McNally"],
          "token_ids": [
            "17162282412521239209404255350428236324471624953933197764496515696146602689810",
            "74731345471819956774387334586905453869113310035587873173616096006033744318106"
          ]
        }
      }
    ],
    "confirmed_fills": [
      {
        "position_id": "1666644547653825639538654505467109608411697937035881104213580452779446501377",
        "order_hash": "0x9fd9da991a3d8f82bfb13e2901422a1621d87db1e27ce4da33fd5a61dec4f4b7",
        "maker": "0xe2315b15280fc49bc6e60eaaeea30c0df64493a5",
        "taker": "0x0d8b4fb38999aaf7658df758f3587d25fe7fd417",
        "side": "BUY",
        "outcome": "NO",
        "price": 0.43,
        "size": 40.350877,
        "amount_usdc": 17.350878,
        "fee": 0
      },
      {
        "position_id": "1666644547653825639538654505467109608411697937035881104213580452779446501376",
        "order_hash": "0x1eb1c486ccad5622329d3e88147c6e98698521ebff86fcbd27ab7efa7fd458d5",
        "maker": "0x0d8b4fb38999aaf7658df758f3587d25fe7fd417",
        "taker": "0xe3333700ca9d93003f00f0f71f8515005f6c00aa",
        "side": "BUY",
        "outcome": "YES",
        "price": 0.57,
        "size": 40.350877,
        "amount_usdc": 22.999999,
        "fee": 0.4945
      }
    ]
  }
}

The example omits empty optional arrays for readability. Each leg carries the same market object as a combo_execution leg, whose token_ids are the market’s CLOB token IDs in outcome order. combo_status_update is receipt-backed. Its current terminal statuses are:

`execution_status`	Meaning
`CONFIRMED`	The transaction receipt succeeded. Fill arrays are included when the receipt emitted those logs.
`FAILED`	The transaction was mined with a reverted receipt. Fill arrays are normally omitted.

Both values match a subscription filter of status: "confirmed" because both are on-chain receipt results. Do not label every status update successful; always inspect execution_status. If PolyNode did not observe the transaction in the mempool, the receipt event can arrive without pending-only context. In that case pending_detected_at, latency_ms, combo identifiers, decoded legs, and pending-derived wallet/value fields are omitted.

Fields

Confirmation

Field	Type	Description
`tx_hash`	string	Polygon transaction hash; joins to the pending execution
`block_number`	number	Block containing the transaction
`confirmed_at`	number	Confirmation time in Unix milliseconds
`execution_status`	string	`CONFIRMED` for a successful receipt or `FAILED` for a reverted receipt
`pending_detected_at`	number or omitted	Pending detection time when the transaction was observed in the mempool
`latency_ms`	number or omitted	Pending-to-receipt latency; omitted without a pending observation
`combo_condition_id`	string or omitted	Derived combo condition ID when recoverable
`yes_position_id` / `no_position_id`	string or omitted	Combo outcome position IDs when available
`leg_position_ids`	string[] or omitted	Constituent leg position IDs (PositionManager position IDs, the same values as `legs[].position_id`) when available
`legs`	object[] or omitted	Decoded combo legs, each with its `market` metadata
`order_hashes`	string[] or omitted	Exchange order hashes recovered from receipt fills
`confirmed_fills`	object[] or omitted	Receipt-backed maker-perspective fills
`execution_summaries`	object[] or omitted	OrdersMatched-style execution summaries
`fees`	object[] or omitted	FeeCharged logs normalized to USDC where possible
`confirmed_transfers`	object[] or omitted	PositionManager transfer logs
`lifecycle_events`	object[] or omitted	Combo lifecycle events found in the same receipt
`gas_used`	string or omitted	Receipt gas used when available
`effective_gas_price`	string or omitted	Receipt effective gas price when available

Top-level maker_address, signer_address, taker_address, amount_usdc, and notional_usdc can also be present when they are recoverable from the pending execution or receipt. For individual fills, use confirmed_fills[].

Confirmed fill

Field	Type	Description
`position_id`	string	Combo position filled
`order_hash`	string	ExchangeV3 order hash
`maker`	string	Wallet that made the signed order
`signer`	string	Order signer when available
`taker`	string	Receipt’s OrderFilled taker/counterparty
`side`	string	Order maker’s `BUY` or `SELL` direction
`outcome`	string	`YES` or `NO` combo position side
`price`	number	Actual fill price
`size`	number	Shares filled
`amount_usdc`	number	Dollar value filled
`fee`	number	Fee in USDC

combo_status_update is included in the default combo stream:

{
  "action": "subscribe",
  "type": "combos"
}

Real-time Streaming

Event Reference

Perps Streaming

More

Combo Status Update Event

Example

Fields

Confirmation

Confirmed fill

​Example

​Fields

​Confirmation

​Confirmed fill

​Subscribe

Example

Fields

Confirmation

Confirmed fill

Subscribe