Skip to main content
Emitted when a combo transaction confirms on-chain. This event links back to a pending combo_execution when one was observed, and includes exact receipt data when available.
{
  "type": "combo_status_update",
  "timestamp": 1781054112400,
  "data": {
    "event_type": "combo_status_update",
    "tx_hash": "0xb0411705aaefc17991e4121acecd8aad03901ddc359cfdb7cf8773f46942927a",
    "block_number": 88232739,
    "confirmed_at": 1781054112400,
    "execution_status": "CONFIRMED",
    "pending_detected_at": 1781054110000,
    "latency_ms": 2400,
    "combo_condition_id": "0xcombo...",
    "yes_position_id": "123...",
    "no_position_id": "456...",
    "leg_position_ids": ["111...", "222..."],
    "legs": [
      {
        "position_id": "111...",
        "leg_outcome_label": "Yes",
        "market": {
          "title": "Will Team A win?",
          "slug": "will-team-a-win",
          "outcomes": ["Yes", "No"],
          "token_ids": ["111...", "333..."]
        }
      }
    ],
    "maker_address": "0xMaker...",
    "signer_address": "0xSigner...",
    "taker_address": "0xTaker...",
    "confirmed_fills": [
      {
        "position_id": "123...",
        "order_hash": "0xorder...",
        "maker_address": "0xMaker...",
        "taker_address": "0xTaker...",
        "side": "BUY",
        "outcome_side": "YES",
        "price": 0.45,
        "size": 1,
        "maker_amount_e6": "450000",
        "taker_amount_e6": "1000000"
      }
    ],
    "fees": [],
    "confirmed_transfers": [],
    "gas_used": "450000",
    "effective_gas_price": "30000000000"
  }
}

Fields

type
string
required
Always "combo_status_update".
data.tx_hash
string
required
Transaction hash. Match this to combo_execution.data.tx_hash when a pending event was observed.
data.block_number
number
required
Polygon block number where the transaction confirmed.
data.execution_status
string
CONFIRMED, FAILED, MATCHED, MINED, or RETRYING.
data.pending_detected_at
number
Unix milliseconds from the pending event. Present when PolyNode saw the transaction before confirmation.
data.latency_ms
number
Time between pending detection and confirmation.
data.combo_condition_id
string
Derived combo condition ID.
data.yes_position_id
string
YES combo position ID.
data.no_position_id
string
NO combo position ID.
data.leg_position_ids
string[]
Constituent leg position IDs for the combo.
data.legs
object[]
required
Enriched combo legs. Customer-facing status updates are emitted only when all legs are enriched.
data.maker_address
string
Maker wallet when available from the pending order or receipt.
data.signer_address
string
Address that signed the order when available.
data.taker_address
string
Taker / transaction participant when available.
data.amount_usdc
number
USDC-normalized amount when derivable.
data.notional_usdc
number
USDC-normalized notional when derivable.
data.order_hashes
string[]
Exchange order hashes associated with the transaction.
data.confirmed_fills
object[]
Exact ExchangeV3 fill logs decoded from the receipt.
data.execution_summaries
object[]
OrdersMatched-style execution summaries decoded from the receipt.
data.fees
object[]
FeeCharged logs, normalized to USDC where possible.
data.confirmed_transfers
object[]
PositionManager transfer logs for combo positions.

Subscribing

combo_status_update is included in the default combo stream:
{
  "action": "subscribe",
  "type": "combos"
}