Skip to main content
POST
Place or preview an order

Authorizations

x-api-key
string
header
required

Body

application/json
mode
enum<string>
required

"preview" applies rules and limits and stores nothing; "place" places the order. No default.

Available options:
preview,
place
clientOrderId
string
required

Unique per account. Resending the same request with it returns the same order.

Required string length: 1 - 200
fixtureId
string
required
Required string length: 1 - 255
outcomeId
integer
required
side
enum<string>
required

Only back is supported in v1

Available options:
back
stake
object
required
minPrice
string
required

Decimal price floor, at least 1.001

Pattern: ^\d+(\.\d{1,4})?$
acceptBetterOdds
boolean
required
acceptPartialStake
boolean
required

true without expiresAt: immediate or cancel; false: fill or kill

playerId
integer
default:0
Required range: x >= 0
bookmakers
string[]

Bookmakers to split the stake across. Omitted: every bookmaker of the account, except those closed to the API.

Required array length: 1 - 50 elements
Required string length: 1 - 64
expiresAt
string<date-time>

Keep working the remainder until then, at most 1 hour ahead

Response

Default Response

id
string<uuid>
required
clientOrderId
string | null
required
status
enum<string>
required
Available options:
PENDING,
PARTIALLY_FILLED,
FILLED,
EXPIRED,
CANCELLED,
REJECTED
selection
object
required
side
enum<string>
required

Only back is supported in v1

Available options:
back
bookmakers
string[]
required

Bookmakers the stake was split across

requestedStake
object
required

Money amount

filledStake
object
required

Money amount

remainingStake
object
required

Money amount

minPrice
string
required

Decimal price floor

averageFilledPrice
string | null
required

Stake-weighted price of the filled legs

acceptBetterOdds
boolean
required
acceptPartialStake
boolean
required
expiresAt
string<date-time> | null
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
version
integer
required

Goes up by one at every change of the order or one of its bets

bets
object[]
required