v2

latestOpenAPI 3.1.02026-07-265966163.8 KB

V2 Events

Get events with markets for a sport and date

Returns events with full market/odds data for the specified sport and date. This is the primary endpoint for building odds screens.

The response includes meta.delta_last_id which serves as the bootstrap cursor for the /api/v2/markets/delta polling endpoint.

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

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, 38=ATP Tennis, 39=WTA Tennis

datestring date required

Example:2026-01-15

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.

participant_idsstring

Comma-separated participant IDs to filter (max 99)

participant_type'TYPE_TEAM' | 'TYPE_PLAYER' | 'TYPE_RESULT'

Filter participants by type

affiliate_idsstring

Comma-separated sportsbook/affiliate IDs to filter. Common values include DraftKings (19), FanDuel (23), BetMGM (22), Bovada (2), Pinnacle (3).

main_line'true' | 'false'

Only return main lines (primary odds, not alternates)

hide_no_markets'true' | 'false'

Hide events with no market data

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

Response

Events with markets

Example response

{
  "events": [
    {
      "event_id": "816efd1e5767d7133b5bc70c77173a18",
      "event_uuid": "11f1-197d-e93ea800-8c2a-ef6a554ca62d",
      "espn_uid": "s:850~l:851~e:172-2026~c:175628",
      "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"
      }
    }
  ]
}