Skip to main content
POST
Place prediction market order

Authorizations

Authorization
string
header
required

API key in the format dk_live_.... Pass as Authorization: Bearer dk_live_...

Body

application/json
conditionId
string
required

Polymarket market condition ID

outcome
enum<string>
required

Outcome to trade

Available options:
Yes,
No
side
enum<string>
required
Available options:
BUY,
SELL
size
number
required

Number of shares

Example:

50

price
number
required

Tick-aligned limit price between 0.01 and 0.99

Required range: 0.01 <= x <= 0.99
Example:

0.65

tokenId
string

Optional token ID for the chosen outcome. If omitted, Docent resolves it from conditionId and outcome.

Response

Order accepted for asynchronous execution

success
boolean
required
Example:

true

actionId
string
required

Action ID for polling status via /v1/actions

workflowId
string
required

Internal workflow ID