Betfair

Betfair operates the world's largest online betting exchange, where customers back and lay outcomes against each other rather than against a bookmaker. The Betfair Exchange API (API-NG) gives automated clients programmatic access to the exchange - navigating markets, retrieving live prices, placing and managing bets, and reading account state. It is exposed as lightweight JSON-RPC and REST operations over HTTPS under https://api.betfair.com/exchange (the Betting, Accounts, and Heartbeat APIs), with a separate real-time Exchange Stream API delivered over a raw SSL/TCP socket (CRLF-delimited JSON, not WebSocket) for low-latency market and order updates. A Historic Data API and a licensed Vendor (affiliate) API round out the platform. Auth combines an Application Key with a session token (ssoid) obtained from Betfair's identity SSO login.

6 APIs 0 Features
Betting ExchangeSports BettingWageringTradingMarket DataJSON-RPCStreaming

APIs

Betfair Betting API

The core exchange API (SportsAPING). Navigate markets (listEventTypes, listCompetitions, listEvents, listMarketCatalogue), read live prices and depth (listMarketBook, listRunner...

Betfair Accounts API

Account-level operations (AccountAPING) - retrieve account funds and details (getAccountFunds, getAccountDetails), read the account statement (getAccountStatement), list currenc...

Betfair Heartbeat API

A "dead man's switch" (HeartbeatAPING) - the client calls heartbeat on an interval (10-300s preference); if Betfair stops receiving heartbeats it will automatically cancel the c...

Betfair Exchange Stream API

Low-latency, subscription-based push of market and order changes over a persistent raw SSL/TCP socket to stream-api.betfair.com:443. The protocol is CRLF-delimited JSON (one JSO...

Betfair Historic Data API

Programmatic access to purchased historical exchange market data. REST POST operations (GetMyData, GetCollectionOptions, GetAdvBasketDataSize, DownloadListOfFiles, DownloadFile)...

Betfair Vendor API

The Web Vendor Facility for licensed software vendors building web-based betting applications. Uses an OAuth2-style authorization flow so a vendor's web application can obtain a...

Collections

Betfair Exchange API (API-NG)

OPEN

Pricing Plans

Betfair Plans Pricing

4 plans

PLANS

Rate Limits

Betfair Rate Limits

7 limits

RATE LIMITS

FinOps

Betfair Finops

FINOPS

Event Specifications

Betfair Exchange Stream API (SSL/TCP)

AsyncAPI 2.6 description of the Betfair **Exchange Stream API** - Betfair's low-latency, subscription-based push channel for market and order changes. IMPORTANT TRANSPORT NOTE: ...

ASYNCAPI

Resources

🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: Betfair Exchange API (API-NG)
  version: '1.0'
items:
- info:
    name: Identity
    type: folder
  items:
  - info:
      name: Login (interactive).
      type: http
    http:
      method: POST
      url: https://identitysso.betfair.com/api/login
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: Content-Type
        value: application/x-www-form-urlencoded
      body:
        type: text
        data: username=&password=
    docs: Interactive login. Returns a session token used as X-Authentication on exchange calls.
  - info:
      name: Keep Alive.
      type: http
    http:
      method: POST
      url: https://identitysso.betfair.com/api/keepAlive
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
    docs: Refreshes the session token's inactivity timeout.
  - info:
      name: Logout.
      type: http
    http:
      method: POST
      url: https://identitysso.betfair.com/api/logout
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
    docs: Invalidates the session token.
- info:
    name: Betting (SportsAPING)
    type: folder
  items:
  - info:
      name: listEventTypes.
      type: http
    http:
      method: POST
      url: https://api.betfair.com/exchange/betting/rest/v1.0/listEventTypes/
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{ "filter": {} }'
    docs: Returns event types (sports) matching the market filter.
  - info:
      name: listMarketCatalogue.
      type: http
    http:
      method: POST
      url: https://api.betfair.com/exchange/betting/rest/v1.0/listMarketCatalogue/
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{ "filter": { "eventTypeIds": ["1"] }, "marketProjection": ["RUNNER_DESCRIPTION", "EVENT"], "sort": "MAXIMUM_TRADED",
          "maxResults": 10 }'
    docs: Returns published markets with runners/metadata. marketId and selectionId feed placeOrders.
  - info:
      name: listMarketBook.
      type: http
    http:
      method: POST
      url: https://api.betfair.com/exchange/betting/rest/v1.0/listMarketBook/
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{ "marketIds": ["1.234567890"], "priceProjection": { "priceData": ["EX_BEST_OFFERS"] } }'
    docs: Returns live prices, status, and depth for a list of markets. Max request weighting 200.
  - info:
      name: listCurrentOrders.
      type: http
    http:
      method: POST
      url: https://api.betfair.com/exchange/betting/rest/v1.0/listCurrentOrders/
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{}'
    docs: Returns the customer's current (matched and unmatched) orders.
  - info:
      name: placeOrders.
      type: http
    http:
      method: POST
      url: https://api.betfair.com/exchange/betting/rest/v1.0/placeOrders/
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{ "marketId": "1.234567890", "instructions": [ { "orderType": "LIMIT", "selectionId": 47972, "side": "BACK",
          "limitOrder": { "size": 2.0, "price": 3.5, "persistenceType": "LAPSE" } } ] }'
    docs: Places one or more bets. Returns a betId per successful instruction.
  - info:
      name: cancelOrders.
      type: http
    http:
      method: POST
      url: https://api.betfair.com/exchange/betting/rest/v1.0/cancelOrders/
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{ "marketId": "1.234567890", "instructions": [ { "betId": "298537625817" } ] }'
    docs: Cancels unmatched bets, fully or partially.
- info:
    name: Accounts (AccountAPING)
    type: folder
  items:
  - info:
      name: getAccountFunds.
      type: http
    http:
      method: POST
      url: https://api.betfair.com/exchange/account/rest/v1.0/getAccountFunds/
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{}'
    docs: Returns available-to-bet balance, exposure, and commission info.
  - info:
      name: getAccountDetails.
      type: http
    http:
      method: POST
      url: https://api.betfair.com/exchange/account/rest/v1.0/getAccountDetails/
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{}'
    docs: Returns account name, currency, locale, region, timezone, and discount rate.
  - info:
      name: getAccountStatement.
      type: http
    http:
      method: POST
      url: https://api.betfair.com/exchange/account/rest/v1.0/getAccountStatement/
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{ "includeItem": "EXCHANGE" }'
    docs: Returns the ledger of financial transactions on the account.
- info:
    name: Heartbeat (HeartbeatAPING)
    type: folder
  items:
  - info:
      name: heartbeat.
      type: http
    http:
      method: POST
      url: https://api.betfair.com/exchange/heartbeat/rest/v1.0/heartbeat/
      headers:
      - name: X-Application
        value: '{{appKey}}'
      - name: X-Authentication
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{ "preferredTimeoutSeconds": 60 }'
    docs: Dead man's switch. If Betfair stops receiving heartbeats within the timeout it cancels unmatched bets.
- info:
    name: Historic Data
    type: folder
  items:
  - info:
      name: GetMyData.
      type: http
    http:
      method: POST
      url: https://historicdata.betfair.com/api/GetMyData
      headers:
      - name: ssoid
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{}'
    docs: Returns the historical data packages the customer has purchased.
  - info:
      name: DownloadListOfFiles.
      type: http
    http:
      method: POST
      url: https://historicdata.betfair.com/api/DownloadListOfFiles
      headers:
      - name: ssoid
        value: '{{sessionToken}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{ "sport": "Horse Racing", "plan": "Basic Plan", "fromDay": 1, "fromMonth": 1, "fromYear": 2024, "toDay": 31,
          "toMonth": 1, "toYear": 2024 }'
    docs: Returns a list of downloadable file paths matching a filter.