Skip to main content
The Apexium API gives two prices for the same selection: the odds of the market data, and the price of the betslip. They answer different questions, so they can differ.

Market data odds

The odds of the market data are raw bookmaker market data: the price each of your bookmakers shows, as OddsPapi collects it. Use them to find fixtures and outcomes, follow the market and compare bookmakers. They are the same for every Apexium account, apart from the list of bookmakers. See Market data and identifiers.

The betslip

The betslip is what your account gets. For one selection, it answers for each of your bookmakers:
  • active: whether the bookmaker can take a bet on this selection right now.
  • price: the price after your account’s rules.
  • minStake and maxStake: the smallest stake the bookmaker accepts, and the largest stake your account can place there.
When active is false, the other fields are null.

Why they differ

  • Your account’s rules. Your agent sets the rules of your account. They can change the price and the largest stake you get at a bookmaker, or keep a bookmaker out of a selection. The betslip applies them; the market data does not.
  • Live checks. At some bookmakers, the betslip asks the bookmaker for its price and limits at the moment you read it. It can then be more recent than the last odds you received.
  • Stake limits. The market data has none of your account’s limits. The betslip gives the stake range of your account at each bookmaker, within the bookmaker’s own limits.
A bookmaker can therefore show odds in the market data and be active: false in the betslip.

Before you place

1

Find the selection

Read its fixtureId, outcomeId and playerId from the market data.
2

Read its betslip

Call GET /v1/betslip once, or subscribe to the betslip channel to follow it.
3

Preview, then place

Take minPrice from the betslip price, preview the order, then place it. See Preview and place.
A betslip price sent as minPrice places at the bookmaker’s current price. A minPrice taken from the market data can be above the price your account gets: the order can then fail its price check. See Errors. Prices move. The betslip and the preview show the market at the moment you read them; they reserve nothing.