All timestamps are UTC. Breaking changes are called out explicitly — subscribe to the
status WebSocket channel and watch this page before upgrading.2026-10-09
✨ Added
- Two surfaces:
/fixtures/*and/futures/*. Every selection endpoint now lives under an explicit prefix:GET /fixtures/betslip,POST /fixtures/place-orders,GET /fixtures/orders,GET /fixtures/bets,GET /fixtures/markets, and the/fixtures/cancel-*pair — plus the mirrored/futures/*set. See Overview → Two surfaces. - The
/futures/*surface exists, and every endpoint on it answers501— includingGET /futures/betslipandGET /futures/markets. Futures are switched off at the feed until OddsPapi’s db-v2 identifier scheme is live (expected late 2026-10): ABP speaks db-v2 futures identifiers only, so there is nothing to serve yet. The routes, the parameters and the request validation are final, so an integration written against them today needs no change on the day futures turn on. A bare-integerfutureIdfrom the current feed is refused (400).
🔁 Changed
- The pre-split paths keep working as deprecated aliases (
/betslip,/place-orders,/orders,/bets,/markets,/cancel-orders,/cancel-all-orders) — same handlers, same behaviour, no removal date. They are markeddeprecatedin the OpenAPI spec; migrate to/fixtures/*at your own pace. requestUuidis normalised. ABP now rewrites the key to the canonical lower-case hyphenated form, so the value echoed back on an order may differ in spelling from the one you sent. This closes a real hole: a retry that changed case used to be accepted as a second distinct order. Match on the canonical form, not on a byte comparison. See Core Concepts → Idempotency.
⚠️ Breaking (futures fields only)
The fixture endpoints no longer accept futures identifiers. Both changes affect only fields that previously answered501 Not Implemented, so no working call changes behaviour:
POST /fixtures/place-orders(and its deprecated aliasPOST /place-orders) rejectsfutureId/futureOutcomeId/participantIdwith422instead of501.GET /fixtures/betslip(and its deprecated aliasGET /betslip) no longer declaresfutureIdorparticipantId; a futures selection answers400instead of501, pointing at/futures/betslip.
🚧 Still to come
- Futures placement and futures order/bet reads —
POST /futures/place-orders,POST /futures/cancel-orders,POST /futures/cancel-all-orders,GET /futures/orders,GET /futures/betsandGET /futures/bets/{betId}answer501. They validate first (422on a bad body,400on a bad filter), so an integration built against them today needs no change the day placement lands.
2026-06-17
🔁 Changed
- Single source of truth for currency. An account’s trading currency now comes solely from
accounts.currencyId; default-currency guessing has been removed. Order stakes are denominated inorderCurrency(defaultUSD), while bets and balances use the account’s native currency. See Currency & Limits. - REST betslip path aligned with the WebSocket path so both transports return identical odds/limit shapes.
🔧 Improved
- Expanded documentation: new Core Concepts, Order Placement (with copy-paste recipes), Currency & Limits, Limits & Reliability, and Bookmakers guides, plus a full message/payload reference folded into the WebSocket guide.
Earlier
✨ Added
- 32 bookmaker integrations behind a single API — sportsbooks, betting exchanges, prediction markets, and punter platforms. See Bookmakers.
- Smart order routing with single and multi-bookmaker placement, partial fills, and exchange sweep mode.
- Reliable WebSocket delivery — opt-in at-least-once delivery with
ack/ack_batch/replayand a 100-message buffer. - Request deduplication — per-order
requestUuididempotency with a 30-minute TTL. - Analytics —
GET /positionsandGET /pnlfor aggregated exposure and profit/loss.
🚧 Coming soon
- Futures / outright markets via
futureId+futureOutcomeId+participantId. The routes and the request model are in place under/futures/*; every futures endpoint returns501 Not Implementeduntil OddsPapi’s db-v2 identifier scheme is live.