Skip to main content
POST
/
v1
/
orders
Place Order
curl --request POST \
  --url https://staging-api.polysimulator.com/v1/orders \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "market_id": "<string>",
  "side": "BUY",
  "outcome": "<string>",
  "quantity": "<string>",
  "order_type": "market",
  "price": "<string>",
  "time_in_force": "GTC",
  "client_order_id": "<string>",
  "max_slippage_bps": 5000
}
'
{
  "order_id": 123,
  "status": "<string>",
  "order_type": "<string>",
  "side": "<string>",
  "outcome": "<string>",
  "price": "<string>",
  "quantity": "<string>",
  "notional": "<string>",
  "fee": "<string>",
  "filled_at": "<string>",
  "price_source": "<string>",
  "slippage_bps": 123,
  "account_balance": "<string>",
  "position": {}
}

Headers

​
Idempotency-Key
string | null
​
X-API-Key
string
required

Your PolySimulator API key

Body

application/json
​
market_id
string
required

Polymarket condition_id

Maximum string length: 256
​
side
enum<string>
required
Available options:
BUY,
SELL
​
outcome
string
required

Outcome label, e.g., Yes or No

Maximum string length: 200
​
quantity
string
required

Number of shares as decimal string, e.g. '10.5'

​
order_type
enum<string>
default:market

Order type

Available options:
market,
limit
​
price
string | null

Limit price as decimal string (0.01-0.99), required for limit orders

​
time_in_force
enum<string>
default:GTC

GTC = Good-Til-Cancel, IOC = Immediate-or-Cancel

Available options:
GTC,
IOC
​
client_order_id
string | null

Idempotency key

Maximum string length: 256
​
max_slippage_bps
integer | null

Max slippage for market orders (basis points)

Required range: 0 <= x <= 10000

Response

Successful Response

​
order_id
integer
required
​
status
string
required
​
order_type
string
required
​
side
string
required
​
outcome
string
required
​
price
string
required
​
quantity
string
required
​
notional
string
required
​
fee
string
required
​
filled_at
string | null
​
price_source
string | null
​
slippage_bps
integer | null
​
account_balance
string | null
​
position
Position · object