Skip to content
datasportsAPI

Betting oddsOdds by day

Documentation

/

Type to filter the docs by title or path.

Betting oddsEndpoint 109 of 116

Odds by day

GET

/v2/odds

Plan
Pro + Business
Auth
Bearer dsa_live_…
Parameters
1 required · 1 optional
Returns
FeaturedOdds[]
Try 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 and Business plans.

Plan access

Requires a Pro or Business plan; every other plan receives 403 endpoint_not_in_plan.

Worth knowing

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.

01Parameters

  • sportqueryRequired

    sport slug, as listed by /v2/sports

  • datequeryOptional

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

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/odds?sport=…"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
FeaturedOdds[]
meta
count, date, sport
ObjectsFeaturedOdds
Example response
{ "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, … }, … ] } }, … ],
  "meta": { "count": 450, "date": "2026-11-04", "sport": "football" } }

04Errors

  • 400bad_request

    sport is missing or not recognised, or the date is not in YYYY-MM-DD form

  • 403endpoint_not_in_plan

    returned to keys on the Free and Starter plans

  • 403history_not_in_plan

    your plan’s history does not reach back to that date

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code