Overview
The Basketball Tournament Simulations feed provides traditional team metadata and tournament-level probability outputs. Team data includes name, code, club details, area, conference, division, and team type. Prediction data includes likelihoods and ratings for outcomes such as winning a tournament, qualifying for knockout phases, round-by-round advancement, wins and losses by quadrant, offensive rating, defensive rating, total rating, rank, and rank change.
The feed is designed for tournament calendar, contestant, and Stats ID-based simulation use cases where applications need structured probability outputs alongside team identity, competition context, and rating information.
Problem Statement & Use Cases
This API solves the business problem of converting basketball tournament simulation outputs into queryable, structured data that can be used in analytics, editorial, and product experiences. It helps applications compare teams, forecast advancement, track ranking movement, and expose tournament probabilities in a consistent machine-readable format.
| Use Case |
Description |
| Tournament projection dashboards |
Display each team's probability of winning a tournament, advancing through each round, or reaching the championship game. |
| Bracket analytics and fan experiences |
Power bracket tools with round-by-round advancement probabilities, rankings, and rating-based team comparisons. |
| Team strength models |
Use offensive rating, defensive rating, total rating, wins, losses, rank, and rank change as structured model features. |
| Editorial and broadcast graphics |
Support previews, matchup analysis, and data visualizations with simulation-backed team probabilities and ratings. |
Compliance & Guidelines
Authentication and API Security
To comply with Stats Perform API security and best-practice requirements, refer to the Stats Perform FAQs, API Overview, and Authentication Guide.
Authentication uses the OAuth method to fetch data.
Polling Frequency
Do not exceed the rate confirmed by Stats Perform. Contact a Stats Perform representative for higher rate limits or clarification.
| Feed |
Polling Frequency |
| Tournament Simulations (TM11) |
Once every 24 hours |
Request Formatting Rules
All URLs are case-sensitive. URL strings must contain the correct case, operators, and required parameters, or the API returns an error.
| Rule |
Requirement |
| Query string start |
Begin the query parameter string with ? immediately after the feed name. |
| Parameter separator |
Separate query parameters with &. |
| Multiple values: AND |
Use & for multiple values where the API treats them as AND. |
| Multiple values: OR |
Use , only if the parameter supports OR-style multiple values. |
| NOT operator |
Use ! only if the parameter supports negation. |
| Underscore-prefixed parameters |
Include the required _ prefix for parameters such as _fmt and _clbk. |
| Placeholder braces |
Remove placeholder curly braces {} from production API calls. They are documentation examples only. |
| Case sensitivity |
Preserve exact URL, parameter, and operator case. |
| Base URL reference |
The base URL format is {protocol}://{requestDomain}/{feedResource}. |
JSONP Requirements
If _fmt=jsonp is used, it must be combined with the callback parameter _clbk.
| Constraint |
Requirement |
Reason |
| JSONP callback |
Use _fmt=jsonp together with _clbk. |
JSONP requires a callback wrapper function. |
| Fixed callback value |
Use a fixed _clbk value whenever possible. |
Random callback names can reduce cacheability and violate API best-practice logic. |
| JavaScript frameworks |
Override framework-generated random callback names, including defaults from common frameworks such as jQuery. |
Some frameworks generate random JSONP function names unless explicitly configured. |
Endpoints
Base URL
https://api.statsperform.com
Feed Resource
/sdapi/v1/basketballdata/tournamentsimulations
Get Tournament Simulations by Query Parameters
GET /sdapi/v1/basketballdata/tournamentsimulations?{queryParameters}
| Usage |
Feed |
| Get Tournament Simulations data according to specified parameter values. |
/sdapi/v1/basketballdata/tournamentsimulations?{queryParameters} |
Get Tournament Simulations by Tournament Calendar Inline Path URL
GET /sdapi/v1/basketballdata/tournamentsimulations/{tmclUUID}?_fmt={format}
| Usage |
Feed |
| Get Tournament Simulations list by tournament calendar UUID inline path URL. |
/sdapi/v1/basketballdata/tournamentsimulations/{tmclUUID}?_fmt={format} |
Example Request Pattern
GET https://api.statsperform.com/sdapi/v1/basketballdata/tournamentsimulations?{queryParameters}
Query Parameters
This feed uses Global query parameters and the feed-specific query parameters listed below.
The /tournamentsimulations feed must be queried by a specific tournament calendar UUID or team UUID, and additional query parameters can be combined in a request when supported.
Feed-Specific Query Parameter Combinations
| Query Parameter Combination |
Description |
Example Request |
tmcl |
Get Tournament Simulations list by tournament calendar UUID. |
GET https://api.statsperform.com/sdapi/v1/basketballdata/tournamentsimulations?tmcl={tmclUUID}&_fmt=xml |
{tmclUUID} path parameter |
Get Tournament Simulations list by tournament calendar UUID inline path URL. |
GET https://api.statsperform.com/sdapi/v1/basketballdata/tournamentsimulations/{tmclUUID}?_fmt=xml |
tmcl as Stats tournament calendar ID |
Get Tournament Simulations list by Stats ID. |
GET https://api.statsperform.com/sdapi/v1/basketballdata/tournamentsimulations?tmcl=urn:perform:stats:tournamentCalendar:{statsID}&_fmt=xml |
tmcl + ctst |
Get Tournament Simulations list by tournament calendar UUID and contestant UUID. |
GET https://api.statsperform.com/sdapi/v1/basketballdata/tournamentsimulations?tmcl={tmclUUID}&ctst={ctstUUID}&_fmt=xml |
tmcl + date |
Get Tournament Simulations list by tournament calendar UUID and date range. |
GET https://api.statsperform.com/sdapi/v1/basketballdata/tournamentsimulations?tmcl={tmclUUID}&date={dateRange}&_fmt=xml |
Stats tmcl ID + Stats team ID |
Get Tournament Simulations list by Stats tournament calendar ID and Stats contestant ID. |
GET https://api.statsperform.com/sdapi/v1/basketballdata/tournamentsimulations?tmcl=urn:perform:stats:tournamentCalendar:{statsID}&ctst=urn:perform:stats:contestant:{statsID}&_fmt=xml |
Parameter Definitions
| Parameter |
Required |
Description |
Accepted Values / Format |
Notes |
_fmt |
No |
Response data format. |
{dataFormat}, such as xml, json, or jsonp. |
Global query parameter. Required in examples. |
_clbk |
Conditional |
JSONP callback function name. |
Fixed callback function name. |
Required when _fmt=jsonp. |
tmcl |
Conditional |
Filters Tournament Simulations by tournament calendar UUID or Stats tournament calendar URN. |
UUID or urn:perform:stats:tournamentCalendar:{statsID} |
Required for tournament-calendar scoped requests. |
{tmclUUID} |
Conditional |
Tournament calendar UUID passed as an inline path parameter. |
String; alphanumeric UUID |
Used in the inline path URL method. |
ctst |
Conditional |
Filters Tournament Simulations by contestant/team UUID or Stats contestant URN. |
UUID or urn:perform:stats:contestant:{statsID} |
Can be combined with tmcl. |
date |
No |
Filters Tournament Simulations by date or date range. |
Date range value |
Can be combined with tmcl. |
Stats ID Constraints
StatsID for a tmcl is the combination of season and competition ID.
StatsID for a ctst is the Stats Team ID.
| Constraint |
Requirement |
| Tournament calendar Stats ID |
Use urn:perform:stats:tournamentCalendar:{statsID} as the tmcl value. |
| Contestant Stats ID |
Use urn:perform:stats:contestant:{statsID} as the ctst value. |
| Placeholder removal |
Remove {} placeholder braces from production calls. |
| Global parameters |
Global query parameters can be combined with feed-specific parameters when supported. |
Entity Filtering Constraints
| Constraint |
Requirement |
| Required entity scope |
Query by a specific tournament calendar UUID or team UUID. |
| Tournament calendar query method |
Use tmcl={tmclUUID} for query-parameter filtering. |
| Tournament calendar path method |
Use /tournamentsimulations/{tmclUUID} for inline path filtering. |
| Contestant/team filtering |
Combine ctst={ctstUUID} with tmcl={tmclUUID} when filtering by team within a tournament calendar. |
| Date filtering |
Combine date={dateRange} with tmcl={tmclUUID} when filtering by date range. |
Output Schema
The feed response fields are documented using XML element names. JSON responses contain similar fields, but XML-only schema attributes or XML-only wrapper nodes may be omitted or represented differently.
`<tournament
Simulations>`
| Property |
Value |
| Nesting |
tournamentSimulations |
| Description |
Required root element of the fields related to Tournament Simulations. |
| Attribute |
Required |
Description |
Values |
xmlns:basketballdata |
Yes |
XML schema reference. Returned for XML only. |
http://www.performgroup.com/schema/basketballdata |
<competition>
| Property |
Value |
| Nesting |
tournamentSimulations/competition |
| Description |
Required root element of the related fields for competition. |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID of the competition. |
String; alphanumeric UUID |
name |
Yes |
Name of the competition. |
String |
`<tournament
Calendar>`
| Property |
Value |
| Nesting |
tournamentSimulations/tournamentCalendar |
| Description |
Required root element of the related fields for tournament calendar. |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID of the tournament calendar. |
String; alphanumeric UUID |
statsId |
No |
Unique Stats ID of the tournament. |
String |
startDate |
Yes |
Start date in UTC of the tournament calendar. |
Date in format YYYY-MM-DDZ |
endDate |
Yes |
End date in UTC of the tournament calendar. |
Date in format YYYY-MM-DDZ |
name |
Yes |
Name of the tournament calendar. |
String |
<predictions>
| Property |
Value |
| Nesting |
tournamentSimulations/predictions |
| Description |
Required root element of the related fields for predictions. |
| Attribute |
Required |
Description |
Values |
type |
Yes |
League type for predictions. |
String |
lastUpdated |
Yes |
UTC date and time when the information or record was last updated. |
Date/Time in format YYYY-MM-DDThh:mm:ssZ |
<team>
| Property |
Value |
| Nesting |
tournamentSimulations/predictions/team |
| Description |
Required root element of the related fields for team. |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID of a team. |
String; alphanumeric UUID |
statsId |
No |
Unique Stats ID of a team. |
String |
name |
Yes |
Unique name of the team. |
String |
conference |
Yes |
Name of the conference. |
String |
division |
Yes |
Name of the division. |
String |
shortName |
Yes |
Short name of the team. |
String |
clubName |
Yes |
Club name of the team. |
String |
code |
Yes |
Three-character code used for the team name, often used on TV scoreboards. |
String |
type |
No |
Type of team; indicates whether it is a normal club or a national team. |
String; one of club, national |
teamType |
No |
Team type. |
String; one of default, women, youth |
areaId |
No |
Unique Area UUID of the team. |
String; alphanumeric UUID |
area |
No |
Area name to which the team belongs. |
String |
city |
No |
City name to which the team belongs. |
String |
<predicted>
| Property |
Value |
| Nesting |
tournamentSimulations/predictions/team/predicted |
| Description |
Required root element of the related fields for prediction types. |
| Attribute |
Required |
Description |
Values |
type |
Yes |
Type of prediction being made. |
String; see enumerated values below |
value |
Yes |
Percentage value for the prediction type. |
String |
Enumerated <predicted> Type Values
| Value |
Description |
Losses |
Predicted losses. |
Wins |
Predicted wins. |
Conference Wins |
Predicted conference wins. |
Conference Losses |
Predicted conference losses. |
Quad 1 Wins |
Predicted Quadrant 1 wins. |
Quad 1 Losses |
Predicted Quadrant 1 losses. |
Quad 2 Wins |
Predicted Quadrant 2 wins. |
Quad 2 Losses |
Predicted Quadrant 2 losses. |
Quad 3 Wins |
Predicted Quadrant 3 wins. |
Quad 3 Losses |
Predicted Quadrant 3 losses. |
Quad 4 Wins |
Predicted Quadrant 4 wins. |
Quad 4 Losses |
Predicted Quadrant 4 losses. |
Record Value |
Predicted record value. |
Rank |
Predicted rank. |
Rank Change |
Predicted rank movement. |
First Round |
Predicted probability or value for reaching or participating in the First Round. |
Second Round |
Predicted probability or value for reaching or participating in the Second Round. |
Regional Semi Final |
Predicted probability or value for reaching or participating in the Regional Semi Final. |
Regional Final |
Predicted probability or value for reaching or participating in the Regional Final. |
National Semi Final |
Predicted probability or value for reaching or participating in the National Semi Final. |
National Championship Game |
Predicted probability or value for reaching or participating in the National Championship Game. |
Offensive Rating |
Predicted offensive rating. |
Defensive Rating |
Predicted defensive rating. |
Total Rating |
Predicted total rating. |
