v9

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-2491679.8 KB

Trading

Submit Order

Submit a signed order returned by buildOrderHosted and get back the resulting order — id, fill status, average price, and the on-chain tx hash once it settles.

built_order_id must come from a recent buildOrderHosted call and be submitted before its expiry. For one-shot order placement, use createOrderHosted instead.

post/v0/trade/submit-order

Request body

built_order_idstring required

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

signaturestring required

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

pull_signaturestring nullable

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.

waitboolean

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.

Response

Order accepted by the hosted backend.

idstring required

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

side'buy' | 'sell' nullable

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

type'market' | 'limit' nullable

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

amountnumber nullable

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.

pricenumber nullable

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

fillednumber

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

remainingnumber

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

statusstring required

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.

feenumber nullable

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

timestampstring nullable

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

tx_hashstring nullable

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

chainstring nullable

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

block_numberinteger nullable

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