Versions Compared

Old Version 104

changes.mady.by.user PepikM

Saved on

compared with

New Version 105

changes.mady.by.user PepikM

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

Table of Content Zone
locationtop

What is an Application Key?

In order to use the Betting & Accounts API, you need to have an Application Key. The Application Key identifies your API client.  Two App Keys are assigned to a single Betfair account, one live App Key and one delayed App Key for testing.

You must pass the Application Key with every HTTP request. You do this by setting the HTTP header with the value of the key assigned by Betfair.

Code Block
X-Application: APP_KEY_ASSIGNED


Note
titleCommercial Usage

Please note: App Key generation is for personal betting purposes only. All data/API usage in any commercial context must be approved by Betfair.

Unauthorised commercial usage will be identified & blocked.

How to Create An Application Key

You can create an Application Key for your Betfair account using the Accounts API Demo Tool and createDeveloperAppKeys operation

  1. Click on the Accounts API Demo Tool link 
  2. Select the createDeveloperAppKeys operation from the list of Operations on the top left hand side of the demo tool.
  3. Enter a sessionToken in the 'Session Token (ssoid)' text box.  You can find instructions on how to find your sessionToken via your browser here.
  4. Enter your Application Name (this must be unique) in the 'Request' column.  The Application Name can be any name of your choice, but like your Betfair username, must be unique.
  5. Press Execute at the bottom of the 'Request' column.

Two Application Keys will then be created and displayed in the Developer Apps column the demo tool

Please note:

  • The X-Application header is not required when using the createDeveloperAppKeys or the getDeveloperAppKeys service.
  • The Application Name must be unique.

 

Note

We are aware that when using some browser versions to create App Keys the Demo Tool throws an UNEXPECTED_ERROR when requesting createDeveloperAppKeys. Using an alternative browser/s should resolve this problem.

You should also ensure that your Application Name is unique as attempts to create a duplicate Application Name will return an APP_KEY_CREATION_FAILED error response.

Live & Delayed Application Keys Usage

The createDeveloperAppKeys service will assign two Application Keys (App Keys) to your Betfair account.

One 'Live' Application Key and one 'Delayed' Application Key. A Delayed Application Key is displayed as 'Version 1.0-DELAY' via createDeveloperAppKeys/getDeveloperAppKeys

Key points:

  • Upon creation, the Live Application Key will be inactive.

  • The Delayed App Key operates on the live (production) Betfair Exchange and not a testbed/sandbox environment.

  • The Delayed App Key should be use for development purposes and any functional testing.  The key provides delayed Betfair price data. The delay is variable between 1-180 second snapshots.

  • The Delayed App Key must also be used in simulation/practice applications where the facility to bet into live Betfair markets is not available.
  • The Delayed App Key does not return traded volume data 'totalMatched' or EX_ALL_OFFERS via listMarketBook. 

How do I activate my Live App Key?

To apply for a a Live Application key please  please take note of the below and provide answers to the following information:

Before applying, please:

Complete any
  • Complete any testing using your Delayed Application key.
  • Ensure that your account has been fully verified in line with our
KYC We
  •   We do not accept licence applications
from
  • from India, Bangledesh, Sri Lanka or the UAE.
  • Check that your account is funded to cover the £299 activation fee.  

Please note: A  A one-off activation fee of of £299 applies applies; this is debited directly from your Betfair account once access is approved.  

To apply for

a

a Live Application key

please contact Developer Support and provide ALL of the following information:
  • Please describe why you need access to the API*
  • Have you completed your coding and testing using the Delayed App Key? *
  • What sports and markets will you bet into? *
  • Of the markets you read, what percentage do you expect to place bets in? *
  • What number of bets will you place per market? *
  • Your anticipated monthly betting volume? *
  • Do you work for or on behalf of a betting operator or any supplier to a betting operator, or have you in the past? If yes, please provide full details. *
  • Where did you hear about the Betfair API? *
    • Confirm that your App Key and access is for my own private use for the purpose of betting on the Betfair Exchange. This access will not be used in any commercial context

     for personal betting use please click here and select Exchange API > For My Personal Betting and complete the application form at the bottom of the page.

    Info
    Detailed Historical Data is additionally made available for testing and analysis purposes.

    Personal Betting Access - Application Key Overview
    Anchor
    PBA
    PBA

    Please see below table for a summary of the data/services available to Delayed & Live Application Keys.

     

    Delayed Application Key

    Live Application Key

    Use ForDevelopmentLive betting applications

    Activation Fee

    None

    £299

    Live Price Data

    Delayed*

    Yes

    Read Only Access Allowed YesNo

    Bet Placement (Live Exchange)

    Yes

    Yes

    Stream API

    Yes (on application)

    Yes (on application)

    Price Levels

    3

    All

    Total Matched by Selection

    Not Available

    Yes

    Total Matched by MarketYesYes
    BSP Far & Near PriceNot Available Yes
     *Delay is variable between 1-180 seconds
    		  


    Commercial Licensing

    Warning
    Please note:  We do not accept licence applications from India, Bangledesh, Sri Lanka or the UAE

    There are a number of different Commercial API licences available and these fit into the definitions below:

    Software Vendor Licence 

    • We wish to create a betting app to distribute to Betfair customers. 

    Please see Developer Support for further information on how to apply for a Software Vendor Licence.

    Odds Publisher Licence 

    • We are a Betfair Affiliate & want to publish Betfair odds. 

    If your not an Affiliate, you can apply via https://affiliates.betfair.com/ > Join Now

    Betting Operator Licence 

    • We are a licensed Betting Operator wanting to use Exchange data.  

    Please contact us via Developer Support for further information.



    ...