Orders

An order is an instruction to buy or sell shares in a market outcome. When you place an order, you specify which market you want to trade, which side (buy or sell), what position to take, and how many shares or how much to spend. Orders are created via POST /orders/, listed via GET /orders/, and canceled via PATCH /orders/{id}/cancel/. For higher-throughput flows, you can also submit, update, or cancel up to 20 orders at once, or cancel everything on your account in a single call.

Order types

Market order
Limit order

Set price to null to place a market order. The order executes immediately at the best available price in the order book.Use market orders when you want guaranteed execution and don’t need to control the exact price.

{
  "market": 42,
  "side": "bid",
  "position": "long",
  "amount": 10.00,
  "currency": "OOM",
  "price": null
}

Set price to a specific value (between 0 and 1) to place a limit order. The order sits in the order book and only executes when a counterparty matches your price.Use limit orders when you want to trade at a specific probability and are willing to wait.

{
  "market": 42,
  "side": "bid",
  "position": "long",
  "amount": 10.00,
  "currency": "OOM",
  "price": 0.45
}

Side: bid vs ask

The side field specifies whether you are buying or selling shares.

Value	Meaning
`bid`	You are buying shares
`ask`	You are selling shares you already hold

Position: long vs short

The position field specifies which direction you are betting.

Value	Meaning
`long`	Betting in favor of the outcome — you profit if it resolves true
`short`	Betting against the outcome — you profit if it resolves false

Long and short positions can both be bought (bid) or sold (ask). For example, selling a long position (ask + long) reduces your existing long exposure.

Order lifecycle

Status	Description
`open`	The order is in the order book, waiting to be matched
`partial_filled`	Some shares have been matched; the rest remain open
`filled`	The order has been fully executed
`canceled`	The order was canceled before fully filling
`processing`	The order is being processed — transient state

Order fields reference

shares vs amount

You can specify how much to trade using either shares or amount — not both.

shares: the number of shares you want to buy or sell
amount: the total monetary value to spend or receive, in the specified currency

Use amount when you want to spend a fixed budget. Use shares when you want to acquire a specific quantity.

expired_at

Set expired_at to an ISO 8601 datetime string to automatically cancel any unfilled portion of the order after that time.If omitted, the order remains open until filled, manually canceled, or the event closes.

{
  "expired_at": "2024-11-05T23:59:00Z"
}

cancel_conflicting_orders

Set cancel_conflicting_orders to true to automatically cancel any of your existing open orders on the same market that would conflict with the new order before placing it.This is useful when you want to change your position without manually canceling previous orders first.

Full order fields

Field	Type	Description
`market`	integer	ID of the market (outcome) to trade
`side`	string	`bid` (buy) or `ask` (sell)
`position`	string	`long` or `short`
`price`	float \| null	Limit price 0–1, or `null` for a market order
`shares`	float	Number of shares (use instead of `amount`)
`amount`	float	Monetary amount to spend (use instead of `shares`)
`currency`	string	`OOM`, `USDC`, `USDT`, or `USD`
`expired_at`	datetime	Auto-cancel time for unfilled order
`cancel_conflicting_orders`	boolean	Cancel conflicting open orders before placing

Real money orders (USDC, USDT, USD) are restricted in some countries. See Currencies for details.

Get Started

Core Concepts

Guides

Order types

Side: bid vs ask

Position: long vs short

Order lifecycle

Order fields reference

Full order fields

​Order types

​Side: bid vs ask

​Position: long vs short

​Order lifecycle

​Order fields reference

​Full order fields

Order types

Side: bid vs ask

Position: long vs short

Order lifecycle

Order fields reference

Full order fields