Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Betting odds

Odds by day

GET

/v2/odds

Pro and up

View as MarkdownTry in Playground →

Returns the headline market for every fixture of a sport that the bookmaker prices on a given day — the three-way result in sports with draws, otherwise the winner. A complete odds list in a single request. Available on Pro, Business and Enterprise plans.

The day follows the bookmaker’s own list, which may stretch a few hours before or after the UTC day; to place a fixture correctly, take its startTime from /v2/fixtures/{id} or from your own day listing. Updated every few minutes. For all markets on one fixture, call /v2/fixtures/{id}/odds.

Parameters

sport

queryrequired

sport slug, as listed by /v2/sports

date

query

date as YYYY-MM-DD; defaults to the current UTC day

Response

meta
count, date, sport
errors
400 bad_request — sport is missing or not recognised, or the date is not in YYYY-MM-DD form403 endpoint_not_in_plan — returned to keys on the Free and Starter plans403 history_not_in_plan — your plan’s history does not reach back to that date

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/odds?sport=…"
Example
{ "data": [ { "fixtureId": 701210, "market": { "key": "result", "kind": "result", "name": "Full time", "period": "match", "line": null,
      "live": false, "suspended": false, "choices": [ { "name": "1", "outcome": "home", "fractional": "23/10", "decimal": 3.3, … }, … ], "settledBy": null } }, … ],
  "meta": { "count": 450, "date": "2026-11-04", "sport": "football" } }