# betfair-odds.com — Betfair Odds API

> Real-time Betfair exchange odds — back and lay prices with the sizes behind them — for live and prematch markets over REST and WebSocket. Explicit staleness metadata on every response. Independent service; not affiliated with Betfair or Flutter Entertainment.

This is a paid API service. Sign up at https://betfair-odds.com/ to get your API key in seconds — your API key is your login. Paid plans start at $99/mo. Demo access is granted manually by us — ask via Telegram (https://t.me/ArbitrageXpro) with the email on your account.

## For AI assistants integrating this API

- [Full API reference, LLM-optimized](https://betfair-odds.com/llms-full.txt): Every endpoint, parameter, response shape, and code example as plain markdown in a single file. Fetch this first.

## Documentation

- [Full HTML docs](https://betfair-odds.com/docs): Human-readable browser version with tabs and syntax highlighting
- [Landing page & pricing](https://betfair-odds.com/): Plans, sign-up, comparison
- [User dashboard](https://betfair-odds.com/panel): Manage subscription, view usage charts

## REST endpoints

Auth: `x-api-key: YOUR_KEY` header (also accepts `x-portal-apikey`) or `?key=YOUR_KEY` query parameter. Base path `/betfair/v1/`.

`?feed=` accepts `live` or `prematch` and **defaults to `live` when omitted** — only an
unrecognised value returns 400 `bad_feed`. Always send it explicitly.

- [GET /betfair/v1/livemap](https://betfair-odds.com/docs#betfair-livemap): Full snapshot, `{meta, liveMap}`. Optional `&sports=` takes sport NAMES (not numeric ids). Only this endpoint sends the `X-Betfair-Seq` / `X-Betfair-Stale` headers.
- [GET /betfair/v1/events](https://betfair-odds.com/docs#betfair-events): Cheap index, `{meta, events}` where each row is {eventId, team1, team2, sport, tournament, openTimestamp, marketCount}.
- [GET /betfair/v1/events/{eventId}](https://betfair-odds.com/docs#betfair-event): One event, `{meta, event}`. Unknown id → 404 `unknown_event`.
- [GET /betfair/v1/me](https://betfair-odds.com/docs#betfair-me): tier, expiry, ws_active, capabilities, limits, max_connections. Returns 200 even when LAPSED, so it is the right call after any 403.
- [GET /betfair/v1/health](https://betfair-odds.com/docs#betfair-health): Feed freshness. No auth. ALWAYS 200 even when stale — read `feeds.<name>.stale`, never the status code.

## WebSocket push feed

- [WS /betfair/v1/stream](https://betfair-odds.com/docs#betfair-stream): Push feed. Requires the $99/mo WebSocket add-on (included in Pro + WS and Scale), which is separate from the tier.

Authenticate with `{"action":"authenticate","apiKey":"..."}` within 10s; subscribe with
`{"action":"subscribe","feeds":["live"]}`; reply to pings with `{"action":"pong"}` (action-keyed, not
`{"type":"pong"}`). Snapshots arrive under `liveMap` and are chunked at 512 KB — multi-chunk snapshots
carry `seq`/`final`, single-chunk ones carry neither, so never wait unconditionally for `final:true`.
Every plan allows ONE concurrent WebSocket connection; exceeding the cap rejects the NEW socket.

REST error bodies use the field `error`; WebSocket error frames use `code`.

Staleness thresholds: `live` 15s, `prematch` 120s.

## Reference data

- Sports carried (both feeds, values of the `sport` field and the `?sports=` filter): `soccer`, `tennis`, `basketball`, `cricket`, `ice hockey`, `american football`, `baseball`. URL-encode the two-word names (`sports=ice%20hockey`).

- [Errors](https://betfair-odds.com/docs#betfair-errors): REST errors use `{error: "..."}`; WS error frames use `{code: "..."}`.
- [Event response shape](https://betfair-odds.com/docs#event-shape): back and lay ladders with sizes per market/runner, plus meta with seq and staleness.
- [Affiliate program](https://betfair-odds.com/docs#affiliate): Every account gets a unique `?ref=<code>` link visible in the dashboard. Refer paying customers, earn 30% of every payment lifetime. Tracked in panel, manual payouts at $50+ unpaid balance.
- [Rate limits](https://betfair-odds.com/docs#ratelimits): Pro 10 req/sec; Pro + WS 10 req/sec; Scale 30 req/sec.

## Plans

- Betfair Pro: $99/mo ($249/90d) — REST live + prematch, 10 req/sec. No WebSocket.
- Betfair Pro + WS: $149/mo ($379/90d) — Pro plus the WebSocket push feed. Most popular; $49 cheaper than adding the add-on to Pro.
- Betfair Scale: $229/mo ($599/90d) — everything in Pro + WS at 30 req/sec (3x Pro).
- Betfair WebSocket add-on: $99/mo — only for adding push to a plain Pro plan. Pro + WS and Scale already include it and are never double-charged.
- Every plan allows ONE concurrent WebSocket connection. There are no 180-day SKUs.
- Demo access: granted manually by us (not self-serve) — ask on Telegram with your account email.

Live SKUs: https://betfair-odds.com/panel/api/betfair/plans