Skip to main content
An order is your instruction. Its bets are the parts of the stake placed at each bookmaker. The order’s status is derived from its bets, so you can follow an order by reading it alone.

Order statuses

PENDING and PARTIALLY_FILLED are the working statuses: those orders can still change, and cancellation applies to them. FILLED covers partial fills too. An immediate-or-cancel order (acceptPartialStake: true, no expiresAt) that filled 120 of 200 is FILLED with filledStake 120.00. Compare filledStake with requestedStake to know how much filled.

Bet statuses

A placed bet then settles. Its settlement.status is UNSETTLED until then, and one of WON, LOST, VOID, HALF_WON, HALF_LOST, PUSH, CASHOUT after. settlement.amount is your profit or loss on the bet.

Following changes

Every order has a version that goes up by one at each change of the order or of one of its bets. To follow an order, read it and compare version with the last one you saw; when it moved, something changed.
  • One order. GET /v1/orders/{id} or GET /v1/orders/by-client-id/{clientOrderId}.
  • Working orders. GET /v1/orders?status=PENDING&status=PARTIALLY_FILLED.
  • Settlements. GET /v1/bets?settledFrom=… lists the bets settled since a time.

Amounts on an order