Sports Odds and Data API.

$ if [ -z "${THERUNDOWN_API_KEY:-}" ]; then
>   echo "Set THERUNDOWN_API_KEY before running this example." >&2
>   exit 1
> fi
$ DATE=$(date -u +%F)
$ URL="https://therundown.io/api/v2/sports/4/events/$DATE?market_ids=1,2,3&affiliate_ids=19,22,23&main_line=true&hide_closed=true"
$ curl --fail-with-body -sS --connect-timeout 5 --max-time 20 \
>   -D response-headers.txt -o snapshot.json "$URL" \
>   -H "X-TheRundown-Key: $THERUNDOWN_API_KEY"
$ curl_exit_status=$?
$ if [ "$curl_exit_status" -ne 0 ]; then exit "$curl_exit_status"; fi
$ awk 'tolower($1)=="x-datapoints:" {print "Billed data points: " $2}' response-headers.txt
Billed data points: 21
$ jq . snapshot.json

{
  "meta": { "delta_last_id": "11929034100012" },
  "events": [{
    "event_id": "a1b2c3d4e5f6",
    "teams": [
      { "name": "Boston Celtics", "is_away": true },
      { "name": "Los Angeles Lakers", "is_away": false }
    ],
    "score": { "score_away": 112, "score_home": 108 },
    "markets": [
      { "market_id": 1, "name": "moneyline", "participants": [...] },
      { "market_id": 2, "name": "spread", "participants": [...] },
      { "market_id": 3, "name": "total", "participants": [...] }
    ]
  }]
}

The REST samples request DraftKings, BetMGM and FanDuel, the three books on Free. The WebSocket sample requires Ultra or above.

For odds, one datapoint is one returned participant/outcome × line/value × affiliate price row. V2 event snapshot responses also add event, score, and live-state rows. X-Datapoints is authoritative for the billed total on billed responses. X-Datapoints-Breakdown is optional, is not currently emitted by /api/v2/markets/delta. Starter and other delayed plans should request narrow snapshots at an appropriate cadence; every successful snapshot bills its returned rows. Do not seed deltas from delayed-plan body metadata. For /api/v2/markets/delta, use the delta cursor only when the account has a known zero-delay entitlement, the bootstrap response explicitly returns X-Data-Delay-Seconds: 0, and meta.delta_last_id is a valid positive integer (as a number or numeric string). If any condition is missing or invalid, repeat narrow snapshots; see the Efficient Polling guide.