Orders

Create order

Places a new order on an existing betslip.

post/v2/orders/

Request

  • Base URL: https://magicmarkets.com (the document declares no server; this is the origin it was published from)
  • URL: https://magicmarkets.com/v2/orders/
  • Auth: API key in header X-Api-Key

Request body

betslip_idstring required
pricenumber required

Limit decimal price. A bet is taken only at this price or better, and an off-tick limit moves to the first tick that honours it; see "Price ticks".

durationnumber

Order duration in seconds (default 15)

exchange_mode'make_and_take' | 'take_only' | 'dark'

How the order interacts with the exchange. make_and_take: fill against the best available liquidity first; any remaining stake is advertised on the exchange at your price, while the order keeps taking newly available liquidity. take_only: only consume available liquidity; remaining stake is never advertised and other orders cannot match against it. dark: like make_and_take, but the advertised remaining stake is hidden from other customers - they can still match it when their price crosses yours, but they cannot see your price until then. There is no post-only mode: no order type rests in the book without also taking crossing liquidity.

keep_open_irboolean

Keep order open when event goes in-play

user_datastring nullable
request_uuidstring

Idempotency key

accept_partial_fillboolean
accept_better_priceboolean
force_want_priceboolean
current_scoreinteger[]

Placement-time score assertion, [home, away]. When present, the order is rejected with validation_error / non_field_errors: ["event_scores_dont_match"] unless the value matches the live score the exchange holds for the event - use it to avoid placing on a price that has not reacted to a goal yet. Only meaningful for football: for sports without a goal-style running score, and while no score is known yet, the server assumes [0, 0] and rejects any other value. Omit the field to skip the check.

exclude_dangerboolean

When true, only liquidity sources that do not hold bets in danger status are used. When false or omitted, all available liquidity sources are used.

bookie_min_stakesobject

Optional per-source minimum stakes, keyed by source. A source is only used if it can take at least its minimum. Values are [currency, amount] tuples.

placer_typestring nullable

Optional caller-supplied tag recorded against the order.

Response

Order created

status'ok'

Changes

No recorded changes to this operation across all 1 revision of this API.