Submit Order

Opaque key returned by buildOrderHosted. Identifies the server-side build context to submit against.

Hex-encoded EIP-712 signature over BuildOrderHostedResponse.typed_data, produced locally with the wallet key matching user_address.

Hex-encoded EIP-712 signature over BuildOrderHostedResponse.pull_typed_data. Required when the build response returned a non-null pull_typed_data (Polymarket neg-risk markets and sell orders); null otherwise.

When true, the server blocks until on-chain settlement before responding (returns the populated tx_hash). When false, returns immediately with the in-flight order.

Unified order id. Stable across the order's lifetime; reuse it in fetchOrderHosted and cancelOrderHosted.

Order direction. null on cancel responses, which only carry id and status.

Order type echoed from the build. null on cancel responses.

Order size in outcome shares. For market submits, this is the shares actually obtained (tokens_bought / tokens_sold); for resting limit orders it is the total shares originally requested. null on cancel responses.

Limit price in probability units [0, 1] for limit orders. null for market orders and cancel responses.

Shares filled so far. For market submits this equals the shares obtained on-chain; for resting limit orders it is the running fill total.

Shares still outstanding (amount - filled, floored at 0). Reaches 0 when the order is fully filled or cancelled.

Lifecycle status. Open-order values include resting and partial; submit responses pass through the upstream status string (failed when an error was raised); cancel responses return the venue's cancel-acknowledgement status.

Total fee charged for this order, in USDC dollars. null until the venue reports fees (typically after settlement).

ISO-8601 timestamp the order was created on the venue side. null on cancel responses.

On-chain settlement transaction hash on Polygon. null until the order settles on-chain (resting limit orders stay null until matched).

Chain the order settled on. Always polygon for hosted orders today (Opinion settles cross-chain via the same Polygon escrow). null on cancel responses.

Polygon block height at which the order settled. null until settlement.