Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
This endpoint returns the competition fixtures for a specific season. Per each competition, this endpoint will return the following information:
Name of the competition
Fixture date and kick-off time
Home and Away team (with IDs)
Venue
Stage/Round/Group information
Status (scheduled, live, completed, postponed)
https://dde-api.data.imgarena.com/basketball/fixtures?live=true&subscribed=true
OR
https://dde-api.data.imgarena.com/basketball/seasons/{seasonId}/fixtures?live=true&subscribed=true
This allows clients to determine which fixtures are live and available based on a user's licence. The top URL shows all live fixtures and the bottom shows all live fixtures within that seasonId.
https://dde-api.data.imgarena.com/basketball/fixtures?subscribed=true
OR
https://dde-api.data.imgarena.com/basketball/seasons/{seasonId}/fixtures?subscribed=true
The top URL lists the fixtures for which you a user is licensed, and the bottom URL the fixtures within a specific seasonId, that a user is licensed for.
https://dde-api.data.imgarena.com/basketball/fixtures
OR
https://dde-api.data.imgarena.com/basketball/seasons/{seasonId}/fixtures
This top URL lists the fixtures for all competitions (licensed and unlicensed). This is useable for an operator to see what which competitions might be available to purchase from IMGA. The bottom URL is a list of fixtures for a specific seasonId, both licensed and unlicensed.
https://dde-api.data.imgarena.com/basketball/fixtures/{fixtureId}
This allows clients to determine the details for a single fixture
https://dde-api.data.imgarena.com/basketball/fixtures?subscribed=true&status=scheduled&dateFrom=2022-07-07&dateTo=2022-07-10
This allows clients to filter based on the status of a match or group of matches and between specific dates. For example, the above URL would show all matches that are 'scheduled' that a client is a licensed for between 7th July 2022 and 10th July 2022. These additional parameters can be used in conjunction with other support parameters like ?live=true and also be utilised with seasonId to allow a user to filter by status and dateTo and dateFrom within a certain season.
Supported status values are 'scheduled', 'live', 'completed', 'postponed'
Type parameter allows a user to call the fixtures API by 'Official', 'Simulation' or 'Training'. Official will denote any official match collected by our data collection team, Simulation is generally any match we simulate and Training is for internal data collection training.
https://dde-api.data.imgarena.com/basketball/fixtures?dateFrom=2022-09-01&dateTo=2022-09-30&type=official
We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times:
Live Fixtures (Subscribed)
/basketball/fixtures?live=true&subscribed=true
OR
basketball/seasons/{seasonId}/fixtures?live=true&subscribed=true
Every 30 seconds for a fixture
Live fixtures for which a client is licensed. This allows clients to determine which fixtures are live and available.
Fixtures (Subscribed)
/basketball/fixtures?subscribed=true
OR
/basketball/seasons/{seasonId}/fixtures?subscribed=true
Every 60 seconds for an upcoming fixture
The fixtures for a competition for which a client is licensed.
All Fixtures (Unsubscribed)
/basketball/fixtures
OR /basketball/seasons/{seasonId}/fixtures
Every 24 hours
Lists ALL the fixtures for all competitions. This is useful to determine what IMGA covers for that sport.
Key
Value
Accept
application/vnd.imggaming.dde.api+json;version=1
Content-Type
application/json
Authorization
Bearer eyvhaoudfgpdfgo*
For sample JSON files and details of each value with descriptions within the payloads, utilise the following Swagger Pages:
JSON Schema - https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/basketball/get_basketball_fixtures
https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/basketball/getFixturesBySeasonId
JSON Schema with value descriptions - https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/Fixture
This endpoint returns the competition squads for a specific season. Per each competition, this endpoint will return the following information:
Name of the competition
Team name & Id
Player forename, lastname and Id
Shirt Number
Nationality
This allows clients to determine which players are associated to which team and seasonId - https://dde-api.data.imgarena.com/basketball/seasons/{seasonId}/squads
This allows clients to call by teamId - https://dde-api.data.imgarena.com/basketball/squads/{teamId}
We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times:
/basketball/seasons/{seasonId}/squads
Once per 24 hours
Updated on any change to a team and their squad such as a player being called up, a player transfer etc.
Key
Value
Accept
application/vnd.imggaming.dde.api+json;version=1
Content-Type
application/json
Authorization
Bearer eyvhaoudfgpdfgo*
For sample JSON files and details of each value with descriptions within the payloads, utilise the following Swagger Pages:
JSON Schema - https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/basketball/get_basketball_seasons__seasonId__squads
JSON Schema with value descriptions - https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/SeasonSquad
The FastPath API enable you to get information about seasons, fixtures, squads and actions within a specific fixture. It also gives you statistical information about a game.
Our API Reference is organized around core betting workflows: listing all seasons, managing fixtures, getting squads, and listing actions. This API is mainly used by betting and media customers.
The FastPath API follows the general patterns of REST.
List all fixtures.
The Fixtures API lets developers list and manage season fixtures. This is a gateway into the Actions API.
Applications don't need any input to list all fixtures, however information can be filtered by start date and end date. The result is useful for obtaining competiton Ids, season Ids, and stage Ids.
GET https://dde-api.data.imgarena.com/{sport}/fixtures
Retrieves a list of seasons for a specific sport.
sport*
String
A unique name for the requested sport. Example: basketball, soccer, v2/volleyball, snooker
String
subscribed
Boolean
Lists the fixtures for which a user is licensed. Example: true, false
live
Boolean
Allows users to determine which fixtures are live and available based on a user's licence. Example: true, false
status
String
Allows clients to filter based on the status of a match or group of matches. Example: scheduled, live, completed, postponed
dateFrom
Date
DAllows clients to filter between specific dates. Example: 2023-01-01
dateTo
Date
Allows clients to filter between specific dates. Example: 2023-01-01
type
String
Allows clients to filter based on the type of a match or group of matches. Example: official, simulation, training
coverageLevel
String
Accept*
String
application/vnd.imggaming.dde.api+json;version=1
Authorization*
String
Bearer ACCESS_TOKEN
Content-Type*
String
application/json
GET https://dde-api.data.imgarena.com/{sport}/seasons/{seasonId}/fixtures
sport*
String
A unique name for the requested sport. Example: basketball, soccer, v2/volleyball, snooker
seasonId*
UUID
unique id of a requested season
subscribed
Boolean
Lists the fixtures for which a user is licensed. Example: true, false
live
Boolean
Allows users to determine which fixtures are live and available based on a user's licence. Example: true, false
status
String
Allows clients to filter based on the status of a match or group of matches. Example: scheduled, live, completed, postponed
dateFrom
Date
Allows clients to filter between specific dates. Example: 2023-01-01
dateTo
Date
Allows clients to filter between specific dates. Example: 2023-01-01
type
String
Allows clients to filter based on the type of a match or group of matches. Example: official, simulation, training
GET https://dde-api.data.imgarena.com/{sport}/fixtures/{fixtureId}
sport*
String
A unique name for the requested sport. Example: basketball, soccer, v2/volleyball, snooker
fixtureId*
UUID
Unique id of a requested fixture.
The requested list of seasons
id (uuid) - The FastPath-assigned ID of the fixture
name (string) - Descriptive name of the fixture
startDateUTC (datetime) - Start date of the fixture
status (string) - Competition information within the season
type (string) - Round of match within a competition
coverageLevel (string) - Round of match within a competition
teams (Teams) - Round of match within a competition
stage (Stage) - Round of match within a competition
venue (Venue) - Round of match within a competition
id (uuid) - The FastPath-assigned ID of the competition within the season
name (string) - Name of the competition. Example: Israel League Cup
club (Club) - Competition category information
category (Category) - Competition category information
homeTeam (boolean) - Venue information of the competition
name
id (uuid) -
name (string) -
season (Season) -
startDateUTC (datetime) -
endDateUTC (datetime) -
rounds (object) -
groups (object) -
id (integer) - The FastPath-assigned ID of the competiton category
name (string) - Name of the competition category. Example: Men, Women
id (string) - The FastPath-assigned id of the venue. Example: 665e9df6-4587-41b4-9a75-085e56e8579b
name (string) - Descriptive name of the venue. Example: Drive in Arena
location (Location) - Geographic location of the venue. Usually it is the city, country and continent. Example: Tel Aviv, Israel, Asia
name (string) - Name of the venue. Example: Tel Aviv
country (Country) - List of countries where the fixture is played out. Example: Israel
continent (Continent) - List of continents where the fixture is played out. Example: Asia
name (string) - Name of the country where the fixture plays out
name (string) - Name of the continent where the fixture plays out
We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times - once per 12 hours
List all seasons and competitions.
The Seasons API lets developers list and manage competition seasons. This is a gateway into the Fixtures API.
Applications don't need any input to list all seasons, however information can be filtered by start date and end date. The result is useful for obtaining competiton Ids, season Ids, and stage Ids.
GET https://dde-api.data.imgarena.com/{sport}/seasons
Retrieves a list of seasons for a specific sport.
The requested list of seasons.
id (uuid) - The FastPath-assigned ID of the season
name (string) - Name of the season
startDateUTC (datetime) - Start date of the season
endDateUTC (datetime) - End date of the season
competition (Competition) - Competition information within the season
stages (Stages) - Round of match within a competition
id (uuid) - The FastPath-assigned ID of the competition within the season
name (string) - Name of the competition. Example: Israel League Cup
category (Category) - Competition category information
location (Location) - Venue information of the competition
id (integer) - The FastPath-assigned ID of the competiton category
name (string) - Name of the competition category. Example: Men, Women
id (integer) -
name (string) -
name (string) - Name of the venue. Example: Israel
country (List) - List of countries where the competition is played out
continent (object) - List of continents where the competition is played out
name (string) - Name of the continent where the seasion is located. Example: Asia
id (uuid) -
name (string) -
startDateUTC (datetime) -
endDateUTC (datetime) -
rounds (object) -
groups (object) -
We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times - once per 12 hours
sport*
string
A unique name for the requested sport, i.e. basketball.
dateFrom
date
dateTo
date
Accept*
string
application/vnd.imggaming.dde.api+json;version=1
Authorization*
string
Bearer ACCESS_TOKEN
Content-Type*
string
application/json
This endpoint returns the aggregated team standings for a specific season. Per each competition and season, this endpoint will return the following information:
totalWins
homeWins
awayWins
totalLosses
homeLosses
awayLosses
lossesByWalkover
totalDraws
homeDraws
awayDraws
points
last10GamesWinLose
overtimeGamesWinLose
currentStreak
longestWinningStreak
homeStreak
awayStreak
score
homeScore
awayScore
opponentsScore
homeOpponentsScore
awayOpponentsScore
averageScore
averageHomeScore
averageAwayScore
averageOpponentsScore
averageHomeOpponentsScore
averageAwayOpponentsScore
gamesPlayed
gamesWinPercentage
rank
teamId
name
[coming soon]
This allows clients to determine the standings associated to that seasonId.
https://dde-api.data.imgarena.com/basketball/seasons/{seasonId}/standings
This allows clients to determine the standings associated to that stageId
https://dde-api.data.imgarena.com/basketball/seasons/{stageId}/standings
Accept
application/vnd.imggaming.dde.api+json;version=1
Content-Type
application/json
Authorization
Bearer eyvhaoudfgpdfgo*
This section details and describes the values within the standings payload within teamStatistics object
teamId
UUID
3f8d8fd7-2047-86a0-86ce-dc814b1c4817
The unique team Id
name
string
team 1
The team name
totalWins
integer
5
The total number of wins for that team
awayWins
integer
1
The total number of away wins for that team
totalLosses
integer
2
The total number of losses for that team
homeLosses
integer
3
The total number of home losses for that team
awayLosses
integer
2
The total number of home losses for that team
lossesByWalkover
integer
0
The total number of losses by walkover for that team
totalDraws
integer
1
The total number of draws for that team
homeDraws
integer
2
The total number of home draws for that team
awayDraws
integer
3
The total number of away draws for that team
points
integer
18
The total number of points for that team
last10GamesWinLose
string
W W W W W L W L W W
The win/loss game streak for that team
overtimeGamesWinLose
integer or null
1
The number of games that team has lost or won in overtime
currentStreak
integer
2
The current streak for that team
longestWinningStreak
integer
6
The longest winning streak for that team
homeStreak
integer
9
The home streak for that team
awayStreak
integer
4
The away streak for that team
score
integer
2513
The total scores for that team
homeScore
integer
1260
The total home scores for that team
awayScore
integer
1253
The total away scores for that team
opponentsScore
integer
2362
The total opponents score
homeOpponentsScore
integer
1153
The total home opponents score
awayOpponentsScore
integer
1209
The total away opponents score
averageScore
integer/decimal
83.76666666666667
The average score for that team
averageHomeScore
integer/decimal
84
The average home score for that team
averageAwayScore
integer/decimal
83.53333333333333
The average away score for that team
averageOpponentsScore
integer/decimal
78.73333333333333
The average opponent score
averageHomeOpponentsScore
integer/decimal
76.86666666666666
The average home opponent score
averageAwayOpponentsScore
integer/decimal
80.6
The average away opponent score
gamesPlayed
integer
30
The total number of games played
gamesWinPercentage
integer/decimal
0.7666666666666667
The win % of that team
rank
integer
1
The team rank in the standings in that season
id
UUID
28b1c981-31d0-4fe3-2b63-494f75f75825
The UUID relating to that stage
name
string
stage 1
The stage name
id
UUID
ce665f80-01a1-2301-1e48-d8b269eb0713
The UUID relating to that group
name
string
group 1
The group name
externalIncomingDataLineId
UUID
a408f0cb-2da3-4ba2-971b-3a8bc5ae2b10
External Incoming Data LineId
timestamp
date/time
2022-08-18T13:09:17.404816Z
Production timestamp
This REST API endpoint returns all match action packets in a single URL call (which are typically delivered in the 'Live Actions' websocket). Crucially these match action packets are delivered in the API call at the END of the fixture.
The data contained will include all team and player actions happening within the soccer match - this will include; goals, cards, shots and more. For a list of all match actions that are supported, as well as definitions of these actions, please see the following documentation page.
https://docs.imgarena.com/basketball/stream-endpoints-websocket/live-actions
https://dde-api.data.imgarena.com/basketball/fixtures/{fixtureId}/actions
N.B. – Please insert the relevant fixtureId returned from the fixtures API endpoint to return the data. The authentication token provided will be required to make a connection to this websocket endpoint.
We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times:
/basketball/fixtures/{fixtureId}/actions
Once post match
Updated at the end of each match with the full list of match actions
Key
Value
Accept
application/vnd.imggaming.dde.api+json;version=1
Content-Type
application/json
Authorization
Bearer eyvhaoudfgpdfgo*
Please see the live actions websocket 'Response Model' section to understand the actions, definitions. Below is also a small snippet of the JSON schema.
This REST API endpoint returns the final aggregated match stats packet in a single URL call (which are typically delivered in the 'Live match Statistics' websocket). These stats are delivered in the API call at the END of the fixture.
The data contained will include all team and player aggregated stats happening within the basketball match - this will include; goals, cards, corners, shots and more. For a list of all match stats that are supported, as well as definitions of these actions, please see the following documentation page.
https://dde-api.data.imgarena.com/basketball/fixtures/{fixtureId}/statistics
N.B. – Please insert the relevant fixtureId returned from the fixtures API endpoint to return the data. The authentication token provided will be required to make a connection to this websocket endpoint.
We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times:
/basketball/fixtures/{fixtureId}/statistics
Once post match
Updated at the end of each match with the full list of team and player match stats
Key
Value
Accept
application/vnd.imggaming.dde.api+json;version=1
Content-Type
application/json
Authorization
Bearer eyvhaoudfgpdfgo*
Please see the live actions websocket 'Response Model' section to understand the stats, definitions. Below is also a small snippet of the JSON schema