Skip to main content
POST
Place combo
Place a combo you priced with Get combo quote. The stake is debited from your wallet when the combo is placed. See Combos for settlement rules.

Authentication

Write authentication required — X-Public-Key, X-Timestamp, and X-Signature headers. See the Authentication guide.

Request body

string
required
The quoteId returned by Get combo quote. It is the idempotency key: a retry with the same quoteId cannot place a second combo.
array
required
The same 2 to 10 selections you quoted.
number
required
Stake, in the specified currency. Must be greater than 0 and at least the minimum order amount ($1.00 USD / ₦100.00 NGN). Cannot exceed the quote’s maxStake.
string
USD (default) or NGN.
number
Highest combo price you accept, greater than 0 and up to 1. Placement re-prices the combo. If the new price is above maxPrice, the placement is refused with 409 and nothing is debited. Set it to the quoted price to refuse any upward move.

Example request

Response

Returns the placed combo. List combos, Get combo, and Cash out combo return the same shape.
string
Combo UUID.
string
8-character share code. Anyone can open the combo by this code with Get combo.
string
PENDING, WON, LOST, VOIDED, or CASHED_OUT.
string
PENDING (no leg’s game has started), ACTIVE (at least one leg’s game has started), or COMPLETED (settled or cashed out).
number
Stake, in currency.
string
USD or NGN.
number
Combo price per share (0.00–1.00) at placement.
number
Payout per unit staked. Recomputed when legs are voided.
number
What you receive if every remaining leg wins. Falls when legs are voided.
number
Combo shares held. In NGN a share costs price × 100 and settles at ₦100.00, so shares and potentialPayout differ by a factor of 100.
number
Amount credited to your wallet. Present once the payout, refund, or cashout has been paid.
number
Price per share the combo was cashed out at. Present only when status is CASHED_OUT.
number
Amount the cashout returned, in currency. Present only when status is CASHED_OUT.
number
cashoutAmount per unit staked. Present only when status is CASHED_OUT.
string
ISO 8601 timestamp of the cashout. Present only when status is CASHED_OUT.
boolean
true when you placed the combo. When false, every money field is zero.
integer
Number of legs.
boolean
Whether cashout is currently offered. Confirm with Get combo cashout quote.
boolean
Whether the settlement money has landed in your wallet. Settlement changes status first; the wallet credit follows shortly after.
string
ISO 8601 timestamp.
array
The combo legs, in position order.

Errors