Sign in
Trading (Hosted)

Create Order (Hosted)

Place a limit or market order on Polymarket or Opinion in one call. The SDK builds the EIP-712 order payload, signs it locally with your private_key, and submits it against your PreFundedEscrow balance. Returns the resulting Order — id, fill status, average fill price, fees, and the on-chain settlement tx hash once it lands.

Identify the target outcome by EITHER (a) catalog outcome_id UUID (canonical, cross-venue) OR (b) venue + venue_outcome_id (the venue-native id returned by client.fetch_markets() on a venue client such as pmxt.Polymarket). The natural workflow — market = client.fetch_markets(...)[0]; client.create_order(outcome=market.yes, ...) — works without any catalog UUID lookup.

Use buildOrderHosted + submitOrderHosted separately only when you need to inspect or display the order payload before signing (e.g. a custodial flow where a human approves each trade).

post/v0/trade/create-order

Request body

market_idstring uuid

Catalog market UUID. Optional -- derived from outcome_id or (venue, venue_outcome_id) when omitted.

outcome_idstring uuid

Catalog outcome UUID. Provide this OR (venue, venue_outcome_id).

venue'polymarket' | 'opinion'

Venue name. Required when identifying the outcome via venue_outcome_id instead of the catalog outcome_id UUID.

venue_outcome_idstring

Venue-native outcome identifier (e.g. Polymarket tokenId, Opinion outcome hash). Required when venue is supplied instead of outcome_id.

side'buy' | 'sell' required
order_type'market' | 'limit'
amountnumber required

Order size. For market buys, in USDC; for market sells / limit, in shares.

denom'shares' | 'usdc'
pricenumber nullable

Required for limit orders. Probability in [0, 1].

slippage_pctnumber nullable
user_addressstring required

EVM wallet address that will sign the resulting typed data.

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