General Workflow

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

Step 1. Obtaining Access Keys

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

• access_key
• access_secret_key

Important

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

Step 2. Obtaining Access Token

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

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

curl https://breaking-bet.com/access_keys/{YOUR_ACCESS_KEY}/access_tokens \
  -H 'Authorization: ApiKey {YOUR_SECRET_KEY}' \
  -d '{"service": "arbs_prematch"}'

Instead of arbs_prematch, you can specify another data type, depending on what you need:

• 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.

Token Lifetime

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

Step 3. Creating a Filter

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/bb-{YOUR_ACCESS_KEY}

You can find more details on how to prepare such a request on the corresponding pages of this guide in the Data APIs section.

Step 4. Retrieving Data

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

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

Details about the parameters and response formats of such requests can also be found on the corresponding pages.

Step 5. Decoding IDs with Dictionaries API

Data returned by DataApi often contains IDs of various entities — sport names, bookmakers, outcome types, etc.

To decode these IDs and get human-readable names, you need to use Dictionaries API.

Caching

Rate Limits for Dictionaries API are calculated based on the expectation of caching this data on the client side.

What's Next?

• Learn more about API limitations
• Explore available Data APIs
• Check the Dictionaries API reference