Free odds history API from Oddsmagnet

On this page we are describing how you can obtain odds history from multiple bookmakers across hundreds of markets absolutely for free. We have build a very scalable infrastructure where we are storing odds changes every hour for a lifetime.

Odds history API

This is free API, which lets you get historic odds for multiple bookmakers. You can query data by idividual market for specific year. The template of the call is below:

https://data.oddsmagnet.com/history/{YEAR}/{SPORT}/{LEAGUE}/{MATCH}/{MARKET`}.json

So for example to get all odds history for 2021 Premier League match Brentford vs Arsenal for win market you need to make a call:

https://data.oddsmagnet.com/history/2021/football/england-premier-league/brentford-v-arsenal/win-market.json

The response is an object with data key, which has a list of odds changes. Please note that the list contains only changes of odds ordered as changes accured. An example of individual object is below:

{
    "schema": {
        "fields": [
            {
                "name": "index",
                "type": "integer"
            },
            {
                "name": "id",
                "type": "string"
            },
            {
                "name": "back_decimal",
                "type": "number"
            },
            {
                "name": "start_date",
                "type": "datetime"
            },
            {
                "name": "updated",
                "type": "datetime"
            },
            {
                "name": "bet_with_bookie_name",
                "type": "string"
            },
            {
                "name": "bet_slug",
                "type": "string"
            },
            {
                "name": "market_slug",
                "type": "string"
            },
            {
                "name": "bookie_code",
                "type": "string"
            },
            {
                "name": "best_back_decimal",
                "type": "number"
            }
        ],
        "pandas_version": "0.20.0"
    },
    "data": [
        {
            "index": 0,
            "id": "bh/football/england-premier-league/brentford-v-arsenal-fc/tip/arsenal-fc",
            "back_decimal": 1.87,
            "start_date": "2021-08-13T21:00:00.000Z",
            "updated": "2021-08-08T21:10:46.916Z",
            "bet_with_bookie_name": "Arsenal (Bet At Home)",
            "bet_slug": "arsenal",
            "market_slug": "win-market",
            "bookie_code": "bh",
            "best_back_decimal": 1.93
        }
    ]
}
                    
  • id - individual bet id from bookmaker
  • back_decimal - odd from bookmaker
  • start_date - start datetime of the event
  • updated - timestamp when odd was saved
  • bet_with_bookie_name - acting like a label with bet name and full bookie name
  • bet_slug - bet name without spaces
  • market_slug - market name without spaces
  • bookie_code - bookie code
  • best_back_decimal - best odd at the time of the reading across all bookmakers for the bet

Pre-build linechart visualisations

We also offer free pre-build linechart visualisations, which could be easily embeded into your blog or website. Here is an example of the visualisation below:

To embed this type of visualisation you need to use the following code:

<iframe width="560" height="315" src="https://oddsmagnet.com/charts/football/england-premier-league/brentford-v-arsenal/win-market" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

You need to replace src path to the market you would like to embed.

Embed live odds

At this stage we don't offer an api for live odds, but we offer to embed live odds grids as you see them on our website.

An example of code to embed live odds is below:

<iframe width="560" height="315" src="https://oddsmagnet.com/share-odds/football/england-premier-league/brentford-v-arsenal/win-market" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

You need to replace src path to the market you would like to embed.