THtherundown
V2 Events

Get opening lines for a sport and date

Changed on

Returns events with the earliest recorded price for each available line at each sportsbook. Opening snapshots are available whenever a price has been recorded, including before, during, or after an event.

get/api/v2/sports/{sportID}/openers/{date}

Request

  • Base URL
    https://therundown.io
  • Auth
    API key in header X-TheRundown-Key

Path parameters

sportIDinteger required

Sport ID. Common values: 1=NCAAF, 2=NFL, 3=MLB, 4=NBA, 5=NCAAB, 6=NHL, 7=UFC, 8=WNBA, 9=CFL, 10=MLS, 11=EPL, 16=UEFA Champions League, 33=UEFA Europa League, 34=Liga MX, 38=ATP Tennis, 39=WTA Tennis, 40=PGA Tour Golf, 41=Formula 1

datestring date required

Query parameters

offsetinteger
Example:300

UTC offset in minutes for the date boundary. Use 300 for US Central, 240 for Eastern, 360 for Mountain, 420 for Pacific. Without this, the API day boundary is midnight UTC.

market_idsstring

Comma-separated market IDs. Defaults to 1,2,3 (Moneyline, Spread, Total); for soccer leagues and NHL the default is 1,2,3,563. The soccer 3-way moneyline (home/draw/away) is served on market 1 as three participants; market 563 carries the NHL 60-minute regulation-time line. Limit: 12 market IDs per request. Requests with more than 12 IDs are rejected with a 400: split larger requests into batches of 12, or omit the parameter to use the default. On market-definition endpoints (/api/v2/events/{eventID}/markets, /api/v2/sports/{sportID}/markets/{date}), omitting market_ids returns all available market definitions instead of the default set. Common IDs: 1=Moneyline, 2=Spread, 3=Total, 29=Player Points, 35=Player Rebounds, 38=Three Pointers, 39=Player Assists, 93=Player PRA, 94=Team Totals. Live variants: 41=Live ML, 42=Live Spread, 43=Live Total.

affiliate_idsstring

Comma-separated sportsbook/affiliate IDs to filter. Common values include DraftKings (19), FanDuel (23), BetMGM (22), BookMaker (7), BetCRIS (9), Pinnacle (3), Polymarket US (31), Circa Sports (32), Bet105 (33), and Heritage Sports (34). Availability varies by sport and market. On V2 event endpoints (/api/v2/sports/{sportID}/events/{date}, /api/v2/events/{eventID}, and their openers/closing siblings), affiliate_ids=0 is a scores-only sentinel: the response keeps events, scores, and status and omits markets and price objects. Other endpoints that share this parameter treat affiliate_ids as a sportsbook filter only.

main_line'true' | 'false'

Only return main lines (primary odds, not alternates). On opening and closing endpoints, this selects main lines in the snapshot. Use history to follow which line was main at each timestamp.

event_statusstring

Comma-separated event status strings to include (e.g. STATUS_IN_PROGRESS,STATUS_HALFTIME). Applied before exclude_status.

exclude_statusstring

Comma-separated event status strings to exclude. Applied after event_status.

hide_closed'true' | 'false'

Exclude currently closed lines when true. Omit or set false to retrieve completed historical snapshots; an event can remain when no prices match.

Response

Events with opening market prices

Example response

{
  "events": [
    {
      "event_id": "816efd1e5767d7133b5bc70c77173a18",
      "event_uuid": "11f1-197d-e93ea800-8c2a-ef6a554ca62d",
      "sport_id": 4,
      "schedule": {
        "season_type": "Regular Season",
        "season_year": 2026
      },
      "markets": [
        {
          "market_id": 1,
          "name": "Money Line",
          "participants": [
            {
              "id": 51,
              "name": "New England Patriots"
            }
          ]
        }
      ],
      "live_game_state": {
        "sport": "mlb",
        "last_play": {
          "participants": [
            {
              "role": "batter"
            }
          ]
        },
        "football": {
          "down_distance_text": "3rd & 4 at KC 38",
          "short_down_distance_text": "3rd & 4"
        }
      },
      "affiliate_source_ids": {
        "19": "31580014",
        "23": "34031-88749503"
      }
    }
  ]
}

Changes

  • 5a4eb15704f7Revision changes
    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

  • 75e26606912eRevision changes
    • info

      added the new optional query request parameter exclude_status