Sign in
Trading (Hosted)

Submit Order (Hosted)

Submit a signed order to Polymarket or Opinion and return the resulting Order with id, fill status, average price, and on-chain tx hash. The built_order_id must come from a recent buildOrderHosted call and be submitted before its expiry.

For most callers, prefer createOrderHosted, which builds, signs, and submits in a single call.

post/v0/trade/submit-order

Request body

built_order_idstring required
signaturestring required

Hex-encoded EIP-712 signature.

pull_signaturestring nullable

Signature for the secondary pull-authorization, required when pull_typed_data was returned.

waitboolean

When true, the server waits for on-chain settlement before responding.

Response

Order accepted by the hosted backend.

idstring required
market_idstring uuid nullable
outcome_idstring uuid nullable
side'buy' | 'sell' nullable
type'market' | 'limit' nullable
amountnumber nullable
pricenumber nullable
fillednumber
remainingnumber
statusstring required
feenumber nullable
timestampstring nullable
tx_hashstring nullable

On-chain transaction hash. Null until settled.

chainstring nullable
block_numberinteger nullable

Changes