Skip to main content

WNBA API Documentation

This is the documentation for our WNBA API. To get a more comprehensive understanding of what feeds we have to offer and the data points we deliver via our endpoints, we encourage you to explore the following resources:

All of our API endpoints can be accessed via an HTTP GET request using your API key. The API key can be passed either as a query parameter or using the following HTTP request header.
Ocp-Apim-Subscription-Key: {key}

  • JSON
  • XML

Competition Feeds

Teams, Players & Rosters

Available Endpoints
Subfeed
Teams, Players & Rosters
Returns all teams with information such as city, name, conference, and logo.

Team Profiles - All

Returns all teams with information such as city, name, conference, and logo.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Team[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Venues & Officials

Available Endpoints
Subfeed
GET Stadiums
Venues & Officials
Returns all stadiums with information such as name, city, state, and country.

Stadiums

Returns all stadiums with information such as name, city, state, and country.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Stadium[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Utility Endpoints

Available Endpoints
Subfeed
Utility Endpoints
Returns true if there is at least one game being played at the time of the request. Returns false if there are no games being played at the time of the request.
Utility Endpoints
Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names.
Utility Endpoints
Returns the calendar year of the current season.
Utility Endpoints
Returns a list of all available sportsbooks with their associated unique IDs.

Are Games In Progress

Returns true if there is at least one game being played at the time of the request. Returns false if there are no games being played at the time of the request.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
boolean
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Betting Metadata

Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingEntityMetadataCollection
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Season - Current

Returns the calendar year of the current season.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Season
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Sportsbooks - by Active

Returns a list of all available sportsbooks with their associated unique IDs.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Sportsbook[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Event Feeds

Schedules & Game Day Info

Available Endpoints
Subfeed
GET Schedules
Schedules & Game Day Info
Returns a full schedule of games for the given season. Includes home and away teams, date, start time, stadium, status, quarter, and pre-game lines (moneyline, spread, total).
Schedules & Game Day Info
Returns a full schedule of games for the given season. Includes home and away teams, date, start time, stadium, and status. Also includes IsClosed, which indicates when box scores are finalized.

Schedules

Returns a full schedule of games for the given season. Includes home and away teams, date, start time, stadium, status, quarter, and pre-game lines (moneyline, spread, total).
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Game[]
Included Data Tables:
Ideal For:
Populating calendar views, retrieving GameID’s to link to other feeds, and getting static game metadata
Not Ideal For:
Live scores and game status updates. Use Games - by Date instead.
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
Season
string
true
Year of the season (with optional season type).
Examples: 2019, 2019PRE, 2019POST, 2019REG, etc.

Schedules (Basic)

Returns a full schedule of games for the given season. Includes home and away teams, date, start time, stadium, and status. Also includes IsClosed, which indicates when box scores are finalized.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
SchedulesBasic[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
Season
string
true
Year of the season (with optional season type).
Examples: 2019, 2019PRE, 2019POST, 2019REG, etc.

Scores & Game State

Available Endpoints
Subfeed
Final Only (No Game State)
Returns final scores for games on given date. Including home and away teams, date, start time, stadium, status, quarter, and pre-game lines (moneyline, spread, total).
Live & Final (With Game State)
Returns scores for games on given date. Including home and away teams, date, start time, stadium, status, quarter, and pre-game lines (moneyline, spread, total runs).

Games - by Date [Final]

This is the Final version of this endpoint. For live data, please use Games - by Date [Live & Final].
Returns final scores for games on given date. Including home and away teams, date, start time, stadium, status, quarter, and pre-game lines (moneyline, spread, total).
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
Game[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2019-MAY-16, 2019-MAY-25, etc.

Games - by Date [Live & Final]

Retrieving up-to-the-second high-level game information, such as scores and game status
Returns scores for games on given date. Including home and away teams, date, start time, stadium, status, quarter, and pre-game lines (moneyline, spread, total runs).
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
Game[]
Included Data Tables:
Ideal For:
Score tickers, live dashboards, and checking game status updates
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2019-MAY-16, 2019-MAY-25, etc.

Team & Player Stats

Available Endpoints
Subfeed
Final Only
Returns all statistics for games on given date, including team and player stats, after the game has been completed.
Final Only
Returns all statistics for games on given date, including team and player stats, after the game has been completed.
Final Only
Returns season-long stats for all players in a given season.
Final Only
Returns all season-long stats (i.e. the season total, not each individual game record) for a given team's players in a given season.
Final Only
Returns box score stats for each team for a given date. Team stats are an aggregation of all player stats. Data is updated as each game is completed.
Final Only
Returns season-long stats for all teams in a given season.
Live & Final
Returns all stats for a given game, including team and player stats, during and after games.
Live & Final
Returns box score stats for all players that participated in any game on a given date, during and after games.
Live & Final
Returns team stats for given team's game in given week. All of which is delivered during and after games.

Box Score [Final]

Returns all statistics for games on given date, including team and player stats, after the game has been completed.
Endpoint Notes
Return Type:
BoxScore
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an WNBA game. GameIDs can be found in the Games API. Valid entries are 1686, 1899, etc.

Box Scores - by Date [Final]

Returns all statistics for games on given date, including team and player stats, after the game has been completed.
Endpoint Notes
Return Type:
BoxScore[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2024-MAY-16, 2023-OCT-20, etc.

Player Season Stats

Returns season-long stats for all players in a given season.
Endpoint Notes
Return Type:
PlayerSeason[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
season
string
true

Player Season Stats - by Team

Returns all season-long stats (i.e. the season total, not each individual game record) for a given team's players in a given season.
Endpoint Notes
Return Type:
PlayerSeason[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
season
string
true
team
string
true

Team Game Stats - by Date [Final]

Returns box score stats for each team for a given date. Team stats are an aggregation of all player stats. Data is updated as each game is completed.
Endpoint Notes
Return Type:
TeamGame[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
date
string
true

Team Season Stats

Returns season-long stats for all teams in a given season.
Endpoint Notes
Return Type:
TeamSeason[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
season
string
true

Box Score [Live & Final]

Returns all stats for a given game, including team and player stats, during and after games.
Endpoint Notes
Return Type:
BoxScore
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an WNBA game. GameIDs can be found in the Games API. Valid entries are 1686, 1899, etc.

Box Scores - by Date [Live & Final]

Returns box score stats for all players that participated in any game on a given date, during and after games.
Endpoint Notes
Return Type:
BoxScore[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2024-MAY-16, 2024-OCT-20, etc.

Team Game Stats - by Date [Live & Final]

Returns team stats for given team's game in given week. All of which is delivered during and after games.
Endpoint Notes
Return Type:
TeamGame[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
date
string
true

Player Feeds

Depth Charts, Lineups & Injuries

Available Endpoints
Subfeed
Depth Charts, Lineups & Injuries
Returns all players currently on a team, including biographical information, team, jersey number, position, and injury information.
Depth Charts, Lineups & Injuries
Returns all players on given team, including biographical information, jersey number, position, and injury information.

Player Details - by Active

Returns all players currently on a team, including biographical information, team, jersey number, position, and injury information.
Endpoint Notes
Return Type:
Player[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Player Details - by Team

Returns all players on given team, including biographical information, jersey number, position, and injury information.
Endpoint Notes
Return Type:
Player[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
team
string
true
The abbreviation of the requested team.
Examples: LA, IND.

Betting Feeds

Game Lines

Available Endpoints
Subfeed
Pre-Game Lines
Returns the full-game odds (moneyline, spread, total) for games in a given date. Returns only the most recent data and does not include line movement.
Pre-Game Lines Plus
Returns the full-game core odds (moneyline, spread, total) for a given GameID. Returns only the most recent data and does not include line movement. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.

Pre-Game Odds - by Date

Retrieving the most recent pre-game odds data
Returns the full-game odds (moneyline, spread, total) for games in a given date. Returns only the most recent data and does not include line movement.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
GameInfo[]
Included Data Tables:
Ideal For:
Receiving the most recent pre-game odds across a variety of sportsbooks
Not Ideal For:
Retrieving line movement (Use Pre-Game Odds Line Movement instead)
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2019-MAY-16, 2019-MAY-25, etc.

Pre-Game Odds Line Movement

Returns the full-game core odds (moneyline, spread, total) for a given GameID. Returns only the most recent data and does not include line movement. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
GameInfo[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The unique GameID of the game for which to pull data.

Props

Available Endpoints
Subfeed
Props
The list of current BettingEvents for the given date. Events in this include market information but no outcomes will be included here. Intended to allow both visibility to Events in order to match up Events -> Games via the included GameID (where applicable) as well as provide a list of MarketIDs which are included in the given event.
Props
Returns the full list of BettingEvents for the given season. Intended for those who need to tie BettingEventIDs to GameIDs.
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given BettingEventID.
Props
Returns the markets and available outcomes for a given BettingEventID.
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID.
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID. A Sportsbook Group must be specified as a URL parameter.
Props
Returns Markets and available outcomes for a given event and market type requested. A lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
Props
Returns Markets and available outcomes for a given event and market type requested. A lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint. A Sportsbook Group must be specified as a URL parameter.
Props
This works in the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only. Ideal if your application will only ever require Player Props, but if you also want Team Props etc. it is recommended to use the by Market Type endpoint.
Props
This works in the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only. Ideal if your application will only ever require Player Props, but if you also want Team Props etc. it is recommended to use the by Market Type endpoint. A Sportsbook Group must be specified as a URL parameter.
Props Plus
Returns full line movement for a given BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and not for the most up-to-the-second lines.
Props Plus
Returns full line movement for a given BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and not for the most up-to-the-second lines. A Sportsbook Group must be specified as a URL parameter.

Betting Events - by Date

The list of current BettingEvents for the given date. Events in this include market information but no outcomes will be included here. Intended to allow both visibility to Events in order to match up Events -> Games via the included GameID (where applicable) as well as provide a list of MarketIDs which are included in the given event.
Endpoint Notes
Return Type:
BettingEvent[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2025-05-30, 2025-MAY-28.

Betting Events - by Season

Returns the full list of BettingEvents for the given season. Intended for those who need to tie BettingEventIDs to GameIDs.
Endpoint Notes
Return Type:
BettingEvent[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season. Just the api year, no season codes.
Examples: 2025, etc

Betting Markets - by Event

Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given BettingEventID.
Endpoint Notes
Return Type:
BettingMarket[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets). Valid entries include: 12, 8, etc.

Betting Markets - by Event [Sportsbook Group]

Returns the markets and available outcomes for a given BettingEventID.
Endpoint Notes
Return Type:
BettingMarket[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets). Valid entries include: 12, 8, etc.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Betting Markets - by Game

Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID.
Endpoint Notes
Return Type:
BettingMarket[]
Ideal For:
Receiving a high-level view of all betting markets offered for a game
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameID
integer
true
The GameID of the desired game for which to pull all betting markets (includes outcomes/bets). Valid entries include: 1934

Betting Markets - by Game [Sportsbook Group]

Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID. A Sportsbook Group must be specified as a URL parameter.
Endpoint Notes
Return Type:
BettingMarket[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameID
integer
true
The GameID of the desired game for which to pull all betting markets (includes outcomes/bets). Valid entries include: 1934
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Betting Markets - by Market Type

Retrieving lowest latency betting markets for a given game
Returns Markets and available outcomes for a given event and market type requested. A lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
Endpoint Notes
Return Type:
BettingMarket[]
Ideal For:
Retrieving all betting markets for a given market type within a game
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets). Valid entries include: 12, 8, etc.
marketTypeID
string
true
The Market Type ID of the desired MarketTypes to pull. Some common types include: 1 for `Game Lines` 2 for `Player Props` 3 for `Team Props` 6 for `Game Props`

Betting Markets - by Market Type [Sportsbook Group]

Returns Markets and available outcomes for a given event and market type requested. A lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint. A Sportsbook Group must be specified as a URL parameter.
Endpoint Notes
Return Type:
BettingMarket[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets). Valid entries include: 12, 8, etc.
marketTypeID
string
true
The Market Type ID of the desired MarketTypes to pull. Some common types include: 1 for `Game Lines` 2 for `Player Props` 3 for `Team Props` 6 for `Game Props`
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Betting Player Props - by Game

This works in the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only. Ideal if your application will only ever require Player Props, but if you also want Team Props etc. it is recommended to use the by Market Type endpoint.
Endpoint Notes
Return Type:
BettingMarket[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameId
integer
true
The unique GameID of the game in question.

Betting Player Props - by Game [Sportsbook Group]

Retrieving the lowest latency player props within a game
This works in the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only. Ideal if your application will only ever require Player Props, but if you also want Team Props etc. it is recommended to use the by Market Type endpoint. A Sportsbook Group must be specified as a URL parameter.
Endpoint Notes
Return Type:
BettingMarket[]
Ideal For:
Retrieving all player props for a given game
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameId
integer
true
The unique GameID of the game in question.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Betting Market

Returns full line movement for a given BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and not for the most up-to-the-second lines.
Endpoint Notes
Return Type:
BettingMarket
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets. Valid entries include: 36, 342, etc.

Betting Market [Sportsbook Group]

Returns full line movement for a given BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and not for the most up-to-the-second lines. A Sportsbook Group must be specified as a URL parameter.
Endpoint Notes
Return Type:
BettingMarket
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets. Valid entries include: 36, 342, etc.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100, G1001

Futures

Available Endpoints
Subfeed
Futures
Returns available Futures outcomes for the given season. Does not include line movement.
Futures
Returns available Futures markets for the given season. Does not include line movement. A Sportsbook Group must be specified as a URL parameter.

Betting Futures - by Season

Returns available Futures outcomes for the given season. Does not include line movement.
Endpoint Notes
Return Type:
BettingEvent[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season. Just the api year, no season codes.
Examples: 2025, etc

Betting Futures - by Season [Sportsbook Group]

Returns available Futures markets for the given season. Does not include line movement. A Sportsbook Group must be specified as a URL parameter.
Endpoint Notes
Return Type:
BettingEvent[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season. Just the api year, no season codes.
Examples: 2025, etc
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Contact Us