Events API

Event Odds

GET/v2/event/odds

Every change of the main markets, with the score and minute at that moment.

Parameters

Send every parameter in the query string, including token.

Query parameters
Name	Type	Required	Description
token	string	Required	Your API token.
event_id	string	Required	Event id from the events endpoints.
source	string	Optional	Bookmaker. Only bet365 is available. Default bet365.
since_time	integer	Optional	Only return odds added at or after this UTC epoch.
odds_market	string	Optional	Market keys to return, e.g. odds_market=1,3.

Notes

Market keys are SPORTID_MARKETID. Soccer: 1_1 full time result, 1_2 asian handicap, 1_3 goal line. Basketball: 18_1 money line, 18_2 spread, 18_3 total points.

Only 1 to 3 main markets per sport. For every market, use the Bet365 API.

Request

Call https://api.odds-data-api.com/v2/event/odds with your token. The examples read it from the ODDS_DATA_API_TOKEN environment variable.

curl "https://api.odds-data-api.com/v2/event/odds?event_id=8204771&odds_market=1&token=$ODDS_DATA_API_TOKEN"

Response

JSON with success: 1 and results. Values are strings unless shown otherwise. See Response format and R-Pager.

application/json

{
  "success": 1,
  "results": {
    "stats": {
      "matching_dir": 1,
      "odds_update": {
        "1_1": 1789241232
      }
    },
    "odds": {
      "1_1": [
        {
          "id": "29141890",
          "home_od": "1.440",
          "draw_od": "4.600",
          "away_od": "7.500",
          "ss": "2-1",
          "time_str": "67",
          "add_time": "1789241232"
        },
        {
          "id": "29139112",
          "home_od": "1.500",
          "draw_od": "4.330",
          "away_od": "7.000",
          "ss": "2-1",
          "time_str": "58",
          "add_time": "1789240680"
        }
      ]
    }
  }
}

Errors

A failed call returns success: 0 with an error code. This endpoint can return:

Error codes
error	Meaning
NOT_FOUND	404 Not Found.
AUTHORIZE_FAILED	Token is not provided or is incorrect.
TOO_MANY_REQUESTS	API rate limit exceeded. See X-RateLimit-Reset.
PERMISSION_DENIED	Your plan does not include this call. Contact support if this is wrong.
PARAM_REQUIRED	A required param is missing. Check error_detail.
PARAM_INVALID	A param is invalid. Check error_detail.

Failed call · application/json

{
  "success": 0,
  "error": "PARAM_REQUIRED",
  "error_detail": "event_id"
}

Like every endpoint, it can also return INTERNAL_SERVER_ERROR, METHOD_NOT_ALLOWED and UNDER_MAINTENANCE. See R-Errors.

Try it

GEThttps://api.odds-data-api.com/v2/event/odds?event_id=8204771&odds_market=1&token=YOUR-TOKEN

event_id: 8204771
odds_market: 1
token: YOUR-TOKEN (from the dashboard)

Requests run with your own token and count toward your hourly limit.