Skip to main content
Replace apx_live_… with your key. On a test environment, use the base URL and the key you were given.

1. Get a key

Your agent enables API access on your account. You then create a key in the dashboard, under Preferences → API. The key is shown once: store it in a secret manager. See Authentication.

2. Check the key

The answer names the account, its status, the key in use and the bookmakers you can place on.

3. Read the betslip

The betslip gives the price you can place at, after your account’s rules, and your stake limits. Ask for one selection:
Each bookmaker comes back with active, its price and its stake limits. Fixture and outcome identifiers come from the market data endpoints. Their odds can differ from the betslip price: see Feed odds and the betslip.

4. Preview the order

A preview applies every rule and limit, then tells you what would be placed now. It stores nothing.
The answer has status: "PREVIEW" and one entry in bets per bookmaker the stake would go to.

5. Place it

Send the same body with "mode": "place". A new order answers 201 Created:
The example is shortened. If the connection drops before you read the answer, send the same request again: the clientOrderId makes it return the same order instead of placing a second one. See Idempotency.

6. Read it back

version goes up by one at every change of the order or of one of its bets: compare it to know whether anything moved. See Order and bet life cycle.