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.
`main_line=true` also excludes closed prices while selecting main lines.
For known zero-delay access, this response's positive whole-integer `meta.delta_last_id` can bootstrap `/api/v2/markets/delta` only when this response explicitly reports `X-Data-Delay-Seconds: 0`. If that header is positive, absent, or invalid, use scoped snapshots instead; do not start market-delta polling with `0`.
Read-only Product data or price calculation. Use returned canonical IDs. Access, delay and metered usage follow your connected account; never infer coverage from an empty result. One bounded request, no background polling or automatic retry. Affiliate 27 is excluded. No wagers, account changes or guarantee of returns.
View input schema
{
"type": "object",
"properties": {
"path": {
"type": "object",
"properties": {
"sportID": {
"type": "integer",
"minimum": 1,
"maximum": 2147483647,
"description": "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, 40=PGA Tour Golf, 41=Formula 1\n"
},
"date": {
"type": "string",
"maxLength": 256,
"format": "date"
}
},
"required": [
"sportID",
"date"
],
"additionalProperties": false
},
"query": {
"default": {},
"type": "object",
"properties": {
"offset": {
"default": 0,
"type": "integer",
"minimum": -840,
"maximum": 840,
"description": "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_ids": {
"default": "1,2,3",
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "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.\n**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.\nOn 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.\nCommon 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.\nLive variants: 41=Live ML, 42=Live Spread, 43=Live Total.\n Comma-separated integer IDs; maximum 12, unique, no spaces or encoded aliases."
},
"participant_ids": {
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "Comma-separated participant IDs to filter (max 99) Comma-separated integer IDs; maximum 50, unique, no spaces or encoded aliases."
},
"participant_type": {
"allOf": [
{
"type": "string",
"enum": [
"TYPE_TEAM",
"TYPE_PLAYER",
"TYPE_RESULT"
]
},
{
"type": "string",
"maxLength": 256
}
],
"description": "Filter participants by type"
},
"affiliate_ids": {
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "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.\nOn 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.\n Comma-separated integer IDs; maximum 10, unique, no spaces or encoded aliases. Affiliate 27 is excluded. Scores-only 0 must stand alone."
},
"main_line": {
"default": "false",
"allOf": [
{
"type": "string",
"enum": [
"true",
"false"
]
},
{
"type": "string",
"maxLength": 256
}
],
"description": "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."
},
"hide_closed": {
"default": "false",
"allOf": [
{
"type": "string",
"enum": [
"true",
"false"
]
},
{
"type": "string",
"maxLength": 256
}
],
"description": "Exclude currently closed lines when `true`. Omit or set `false` to retrieve completed historical snapshots; an event can remain when no prices match."
},
"hide_no_markets": {
"default": "false",
"allOf": [
{
"type": "string",
"enum": [
"true",
"false"
]
},
{
"type": "string",
"maxLength": 256
}
],
"description": "Hide events with no market data"
},
"event_status": {
"type": "string",
"maxLength": 256,
"description": "Comma-separated event status strings to include (e.g. `STATUS_IN_PROGRESS,STATUS_HALFTIME`). Applied before `exclude_status`."
},
"exclude_status": {
"type": "string",
"maxLength": 256,
"description": "Comma-separated event status strings to exclude"
},
"include": {
"allOf": [
{
"type": "string",
"enum": [
"all_periods"
]
},
{
"type": "string",
"maxLength": 256
}
],
"description": "Source-supported period inclusion flag; normal plan/live-period entitlement enforcement still applies. Existing Data MCP uses all_periods."
}
},
"additionalProperties": false
}
},
"required": [
"path"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}