General Workflow with the API

For all data types (arbs, middles, valuebets), the API interaction sequence follows a common pattern:

1. In your personal account on the breaking-bet.com website, you need to obtain access keys:

   • access_key
   • access_secret_key

   The secret key is shown once and is no longer stored in plain text. On the next display, a new key will be generated, so to avoid having to update all configuration files where it is used, it must be saved.

2. These credentials are used to automatically obtain a short-lived access token.

   To do this, you need to send a request of the following type:

   curl https://breaking-bet.com/access_keys/{ACCESS_KEY_ID}/access_tokens \
   -H "Content-Type: application/json" \
   -H 'Authorization: ApiKey {YOUR_SECRET_KEY}' \
   -d '{"service": "arbs_prematch"}'

   Instead of arbs_prematch, you can specify another data type, depending on what you're interested in:

   • arbs_prematch - for prematch arbs
   • arbs_live - for live arbs
   • middles_prematch - for prematch middles
   • middles_live - for live middles
   • valuebets_prematch - for prematch valuebets
   • valuebets_live - for live valuebets

   The obtained Access token is used to access one of the Data APIs and retrieve data.

   The access token lifetime is limited to 5 minutes and must be regularly updated as described in step #2.

3. To retrieve the desired data, you first need to configure a filter, whose settings will determine the selection criteria for arbs, valuebets, and middles. Each data type has its own API. For example, to create an arbs filter, you need to send a request like POST https://arbs.prematch.api.breaking-bet.com/filters/{ACCESS_KEY_ID}

   You can learn in more detail how to prepare such a request on the corresponding pages of this guide.

4. After creating a filter, you can start retrieving the desired data from it:

   POST https://arbs.prematch.api.breaking-bet.com/filters/{ACCESS_KEY_ID}/items

   You can also learn in detail about the parameters and response formats of such requests on the corresponding pages.

5. Data returned through DataApi often contains IDs of various entities — names of sports, bookmakers, outcome types, etc. To decode these IDs and get human-readable names, you need to use the Dictionaries API. You can learn more about this service on the corresponding page of this guide. Rate Limits for Dictionaries API are calculated based on the expectation of caching this data on the client side.