ShotTracker Event API Overview ¶

The ShotTracker Event API consists of REST endpoints and websockets to deliver data in realtime. The API reference is broken down into the following sections:

• Live, Live Data, Live Notification

• Locations

• Users

• Teams

Use Cases ¶

Access to ShotTracker data can drive applications and solutions that do the following:

• Display a leaderboard for team and player stats over the course of a season or a real time event.

• Analyze stats and shots to reflect trends over the course of a season or a real time event.

• Show live player movement in applications, broadcast or augmented reality solutions.

• Analyze team and player movement for trends.

Authentication ¶

All requests to the REST API must be signed using the ShotTracker issued username and secret. A ShotTracker API username/secret pair contains specific privileges; be sure to keep both secured.

Signing a request is done using HMAC. The following headers are needed for signing and required to be sent with each request.

Below is a nodejs example illustrating the data required and how to formulate the data into the signing stream.

var crypto = require("crypto");

var userName = 'ShotTracker supplied user name here';
var secret = 'ShotTracker supplied secret here';
var host = 'devapi-shottracker.ddsports.com';
var pathUriWithoutQueryString = '/v1/data/live/_search';
var method = 'GET';
var date = new Date().toUTCString();

var requestLine = method + ' ' + pathUriWithoutQueryString + ' HTTP/1.1';
var stringToSign = 'date: ' + date.trim() + '\n'
                 + 'host: ' + host + '\n'
                 + requestLine;
var encodedSignature = crypto.createHmac("sha1", secret).update(stringToSign).digest("base64");
var hmacAuth = 'hmac username="' + userName + '",algorithm="hmac-sha1",headers="date host request-line",signature="' + encodedSignature + '"';

console.log('date: ' + date);
console.log('Authorization: ' + hmacAuth);

Note Only the API (REST Resources) require a signed request. Authentication to the websocket is done by only providing the acquired subscription token.

Environment Endpoints ¶

Development/ShotTracker Lab ¶

• Development Service API Environment - https://devapi-shottracker.ddsports.com

• Development Websocket - wss://devapi-shottracker.ddsports.com/live/v2/games

Production ¶

• Production Service API Environment - https://api-shottracker.ddsports.com

• Production Websocket - wss://api-shottracker.ddsports.com/live/v2/games

Data Overview ¶

ShotTracker is a sensor based system that captures team and player stats in real time. The data that ShotTracker captures is used to build box scores, plot shots and show player and ball movement. ShotTracker data is broken down into 3 main categories, box score and possession stats, shots and locations.

Box Score Stats ¶

The system will emit all box score stats under the following abbreviations:

In most cases, the stats will be paired together to represent the most current value(s) on the box score for the given player. Stats data will be paired together in single response; the example JSON snippet below represents a made field goal attempt:

{“type”:“stats”,“data”:{“occurred_at”:1500571319432,“team_id”:461,“player_id”:2623,“stats”:{“FGA”:15.0,“FGA2”:15.0",“FG”:8.0,“FG2”:8.0,“PTS”:17.0},“classification”:“TWO_POINT_MAKE”,“version”:1941}}

The values in the above example reflect the most current stat values that would be reflective on the players box score.

Stats can also change with a manual correction. This means the example above would change to the following if the shot is deleted:

{“type”:“stats”,“data”:{“occurred_at”:1500571319432,“team_id”:461,“player_id”:2623,“stats”:{“FGA”:14.0,“FG”:7.0,“PTS”:15.0},“classification”:“DELETED_TWO_POINT_MAKE”,“version”:1942}}

Both adding and deleting of the field goal looks the same in the paired together stats response. As a result a classification field is added to each stats response to give more context around what the collected stats values represent. The following are the general the classification values but do not represent the full list. Stats can be custom made by teams which can also be updatable. Some non-shooting stats are update from one type to another which can also be reflected in the classification.

Possession Stats ¶

Possession stats are grouped together into the following ball movement groups:

Each group could contain the following calculated stat summaries:

Shots ¶

Shots are location data for each made and missed shot including the ShotTracker zones. Below is an example shot:

{“type”:“shot”,“data”:{“occurred_at”:1500571319432,“team_id”:461,“player_id”:2623,“is_make”:true,“is_3point”:false,“zone”:1,“hoop_player_x”:685,“hoop_player_y”:-475,“status”:“RECORDED”}}

See the shot zones layouts below.

Note: All xy data is returned as mm.

Shots can have the following attributes.

Locations ¶

The location data contains plotable xyz data for each player and ball on the court. Below are a few examples:

{“type”:“location”,“data”:{“occurred_at”:1500571321532,“type”:“PLAYER”,“id”:2942,“x”:2314,“y”:-8635,“z”:69,“speed”:0.1,“dist”:1.3}}

{“type”:“location”,“data”:{“occurred_at”:1500571321532,“type”:“BALL”,“id”:2147549498,“x”:-6039,“y”:-8833,“z”:1705,“speed”:0.1}}

The type denotes what sensor; either the player or ball. The id in the PLAYER event relates to the player list from the subscription request. The xyz reflects the current location of the sensor at the given occurred_at. Lastly, the speed (m/s) and distance (km) reflect the current movement speed and total distance traveled by the sensor.

Note: All xyz data is returned as mm.

Data Plotting Concepts ¶

Locations XY Orientation ¶

Zone Map Locations ¶

Shots are assigned a zone number 1 - 14 that represents the specific location around the hoop the shot occurred. The map below shows the shot zones.

Advanced Zone Map Locations ¶

Shots are assigned an advanced zone number 1 - 23 that represents the specific location around the hoop the shot occurred. The map below shows the shot advanced zone.

Shot Chart Plotting ¶

Shot data contains a hoop_player_x and hoop_player_y that represents the xy location of the shot from the hoop. Representing a shot from the hoop assumes that the positive y runs from the hoop to the center of the court and positive x runs from the hoop to the right.

Team Events And Schedules ¶

Content-Type: application/json

{
  "events": [
    {
      "id": "cf3ba789-06c4-11e8-bb65-0242286dfad2",
      "name": "TeamAppTeam vs TestTeamAlpha",
      "results": [
        {
          "id": "cf56d0aa-06c4-11e8-bb65-0242286dfad2",
          "name": null,
          "type": "GAME_ROUND",
          "started_at": 1517430299810,
          "ended_at": 1517431728868,
          "_stats": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/stats",
          "_stats_details": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/stats/details",
          "_shots": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/shots",
          "_locations": [
            "https://api-shottracker.ddsports.com/v1/data/sensors/locations?id=cf56d0aa-06c4-11e8-bb65-0242286dfad2&from=1517430299810&to=1517431728868"
          ],
          "_possessions": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/possessions",
          "_possessions_summary": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/possessions/summary"
        },
        {
          "id": "23d3344b-06c8-11e8-bb65-0242286dfad2",
          "name": null,
          "type": "GAME_ROUND",
          "started_at": 1517431730064,
          "ended_at": 1517431732978,
          "_stats": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/stats",
          "_stats_details": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/stats/details",
          "_shots": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/shots",
          "_locations": [
            "https://api-shottracker.ddsports.com/v1/data/sensors/locations?id=23d3344b-06c8-11e8-bb65-0242286dfad2&from=1517431730064&to=1517431732978"
          ],
          "_possessions": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/possessions",
          "_possessions_summary": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/possessions/summary"
        }
      ],
      "is_practice_event": false,
      "is_game_event": true,
      "started_at": 1517430299810,
      "ended_at": 1517431732978,
      "game_type": "HALF",
      "_self": "https://api-shottracker.ddsports.com/v1/data/teams/12345/games/cf3ba789-06c4-11e8-bb65-0242286dfad2",
      "totals": {
        "_stats_details": "https://api-shottracker.ddsports.com/v1/data/stats/games/cf3ba789-06c4-11e8-bb65-0242286dfad2/stats/details"
      },
      "game_attributes": {
        "home_team_id": 1,
        "home_team_name": "TestTeamAlpha",
        "away_team_id": 2,
        "away_team_name": "TeamAppTeam"
      }
    }
  ]
}

Content-Type: application/json

{
  "status": 422,
  "message": "Both from and to must be greater than 0 | from timestamp must be less than to timestamp | Request may not exceed more than 8 months",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 500,
  "message": "<General System Error Message>",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "live_data_source": "SHOTTRACKER",
  "token": "6141681d-df46-11e6-a818-f20e96351dc1",
  "token_data_types": [
    "STATS",
    "SHOTS",
    "LOCATIONS"
  ],
  "active_state": "LIVE",
  "active_type": "GAME_ROUND",
  "active_team_colors": {
    "teams": [
      {
        "id": 1,
        "color": "FFFF00"
      },
      {
        "id": 2,
        "color": "00FFFF"
      }
    ]
  },
  "active_name": "H1",
  "teams": [
    {
      "id": 461,
      "name": "TeamAppTeam",
      "logo_image_link": "<image link>",
      "gender": "MEN",
      "conference_name": "ACC",
      "league_name": "NCAA",
      "sport": "BASKETBALL",
      "reference_id": "938104592",
      "players": [
        {
          "id": 123,
          "first_name": "John",
          "last_name": "Doe",
          "display_name": "John Doe",
          "jersey_number": 1,
          "jersey_number_str": "1",
          "position": "center",
          "profile_image_link": "<image link>",
          "is_active": true,
          "reference_id": "42589513"
        }
      ]
    }
  ],
  "_stats": "https://api-shottracker.ddsports.com/v1/data/stats/6141681d-df46-11e6-a818-f20e96351dc1/stats",
  "_stats_details": "https://api-shottracker.ddsports.com/v1/data/stats/6141681d-df46-11e6-a818-f20e96351dc1/stats/details",
  "_shots": "https://api-shottracker.ddsports.com/v1/data/stats/6141681d-df46-11e6-a818-f20e96351dc1/shots",
  "_possession": "https://api-shottracker.ddsports.com/v1/data/stats/6141681d-df46-11e6-a818-f20e96351dc1/possessions",
  "_possession_summary": "http://api-shottracker.ddsports.com/v1/data/stats/6141681d-df46-11e6-a818-f20e96351dc1/possessions/summary",
  "event_completed_results": [
    {
      "id": "a59e3734-101f-11e8-be3e-0242286dfad2",
      "started_at": 123456789,
      "ended_at": 234567890,
      "type": "GAME_ROUND",
      "name": null,
      "_stats": "http://api-shottracker.ddsports.com/v1/data/stats/a59e3734-101f-11e8-be3e-0242286dfad2/stats",
      "_stats_details": "http://api-shottracker.ddsports.com/v1/data/stats/a59e3734-101f-11e8-be3e-0242286dfad2/stats/details",
      "_shots": "http://api-shottracker.ddsports.com/v1/data/stats/a59e3734-101f-11e8-be3e-0242286dfad2/shots",
      "_possession": "http://api-shottracker.ddsports.com/v1/data/stats/a59e3734-101f-11e8-be3e-0242286dfad2/possessions",
      "_possession_summary": "http://api-shottracker.ddsports.com/v1/data/stats/a59e3734-101f-11e8-be3e-0242286dfad2/possessions/summary"
    }
  ],
  "event_totals": {
    "team_scores": [
      {
        "id": 1,
        "score": 0
      },
      {
        "id": 2,
        "score": 0
      }
    ]
  }
}

Content-Type: application/json

{
  "status": 400,
  "message": "The live id is no longer active",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 403,
  "message": "No access to LOCATIONS|STATS|SHOTS data",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 404,
  "message": "Invalid id",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 500,
  "message": "<General System Error Message>",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "games": [
    {
      "event_id": "062a3726-3b0f-11eb-86c4-02420043683b",
      "facility_name": "ShotTracker Lab",
      "court_name": "main court",
      "location_id": "/6e4118d4-2e50-11e6-b4a4-deecc6e6f586/6e4118d4-2e50-11e6-b4a4-deecc6e6f581",
      "tournament": null,
      "tipoff_at": 1604052000000,
      "gender": "MEN",
      "status": "ACTIVE",
      "home_team_id": 481,
      "home_team_name": "ShotTrackerW",
      "home_team_reference_id": "938104592",
      "away_team_id": 493,
      "away_team_name": "BWB",
      "away_team_reference_id": "938104593",
      "officials_team_id": 0,
      "_results": "https://api-shottracker.ddsports.com/v1/data/games/cf3ba789-06c4-11e8-bb65-0242286dfad2",
      "reference_id": "938104592",
      "fan_engagement_enabled": false
    }
  ]
}

Content-Type: application/json

{
  "games": [
    {
      "event_id": "062a3726-3b0f-11eb-86c4-02420043683b",
      "facility_name": "ShotTracker Lab",
      "court_name": "main court",
      "location_id": "6e4118d4-2e50-11e6-b4a4-deecc6e6f586@6e4118d4-2e50-11e6-b4a4-deecc6e6f581",
      "tournament": null,
      "tipoff_at": 1604052000000,
      "gender": "MEN",
      "status": "ACTIVE",
      "type": "BASKETBALL",
      "home_team_id": 481,
      "home_team_name": "ShotTrackerW",
      "home_team_reference_id": "938104592",
      "away_team_id": 493,
      "away_team_name": "BWB",
      "away_team_reference_id": "938104593",
      "officials_team_id": 0,
      "_results": "https://api-shottracker.ddsports.com/v1/data/games/cf3ba789-06c4-11e8-bb65-0242286dfad2",
      "reference_id": "938104592",
      "fan_engagement_enabled": false
    }
  ]
}

Content-Type: application/json

{
  "league": "LEAGUE_NAME",
  "games": [
    {
      "id": "abc-123",
      "home_team_id": "abc-123",
      "visitor_team_id": "abc-123",
      "home_team_name": "Team 1",
      "visitor_team_name": "Team 2",
      "gender": "MENS|WOMENS",
      "round_type": "QUARTER|HALF",
      "type": "BASKETBALL|FOOTBALL",
      "label": "Game 1",
      "scheduled_start_timestamp": 1570769231000,
      "season_type": "PRE|REG|POST",
      "week_number": 2
    }
  ]
}

Content-Type: application/json

{
  "status": 403,
  "message": "Restricted resource",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 404,
  "message": "Team or league not found",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 500,
  "message": "<General System Error Message>",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "live_data_source": "SHOTTRACKER",
  "token": "6141681d-df46-11e6-a818-f20e96351dc1",
  "token_data_types": [
    "STATS",
    "SHOTS",
    "LOCATIONS"
  ],
  "active_state": null,
  "active_type": null,
  "active_team_colors": null,
  "active_name": null,
  "teams": [
    {
      "id": 461,
      "name": "TeamAppTeam",
      "logo_image_link": "<image link>",
      "gender": "MEN",
      "conference_name": "ACC",
      "league_name": "NCAA",
      "sport": "BASKETBALL",
      "reference_id": "938104592",
      "players": [
        {
          "id": 123,
          "first_name": "John",
          "last_name": "Doe",
          "display_name": "John Doe",
          "jersey_number": 1,
          "jersey_number_str": "1",
          "position": "center",
          "profile_image_link": "<image link>",
          "is_active": true,
          "reference_id": "42589513"
        }
      ]
    }
  ],
  "_stats": null,
  "_stats_details": null,
  "_shots": null,
  "_possession": null,
  "_possession_summary": null,
  "event_totals": {
    "team_scores": []
  }
}

Content-Type: application/json

{
  "status": 400,
  "message": "The game is no longer active",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 403,
  "message": "No access to LOCATIONS|STATS|SHOTS data",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 404,
  "message": "Invalid id",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 500,
  "message": "<General System Error Message>",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "live_data_source": "SHOTTRACKER",
  "token": "6141681d-df46-11e6-a818-f20e96351dc1",
  "token_data_types": [
    "STATS",
    "SHOTS",
    "LOCATIONS"
  ],
  "active_state": null,
  "active_type": null,
  "active_team_colors": null,
  "active_name": null,
  "teams": [
    {
      "id": 461,
      "name": "TeamAppTeam",
      "logo_image_link": "<image link>",
      "gender": "MEN",
      "conference_name": "ACC",
      "league_name": "NCAA",
      "sport": "BASKETBALL",
      "reference_id": "938104592",
      "players": [
        {
          "id": 123,
          "first_name": "John",
          "last_name": "Doe",
          "display_name": "John Doe",
          "jersey_number": 1,
          "jersey_number_str": "1",
          "position": "center",
          "profile_image_link": "<image link>",
          "is_active": true,
          "reference_id": "42589513"
        }
      ]
    }
  ],
  "_stats": null,
  "_stats_details": null,
  "_shots": null,
  "_possession": null,
  "_possession_summary": null,
  "event_totals": {
    "team_scores": []
  }
}

Content-Type: application/json

{
  "status": 400,
  "message": "The game is no longer active",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 403,
  "message": "No access to LOCATIONS|STATS|SHOTS data",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 404,
  "message": "Invalid id",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 500,
  "message": "<General System Error Message>",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "id": "cf3ba789-06c4-11e8-bb65-0242286dfad2",
  "name": "Team Practice",
  "results": [
    {
      "id": "cf56d0aa-06c4-11e8-bb65-0242286dfad2",
      "name": "Scrimmage Drill 1",
      "type": "SCRIMMAGE",
      "started_at": 1517430299810,
      "ended_at": 1517431728868,
      "_stats": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/stats",
      "_stats_details": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/stats/details",
      "_shots": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/shots",
      "_locations": [
        "https://api-shottracker.ddsports.com/v1/data/sensors/locations?id=cf56d0aa-06c4-11e8-bb65-0242286dfad2&from=1517430299810&to=1517431728868"
      ],
      "_possessions": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/possessions",
      "_possessions_summary": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/possessions/summary"
    },
    {
      "id": "23d3344b-06c8-11e8-bb65-0242286dfad2",
      "name": "Scrimmage Drill 2",
      "type": "SCRIMMAGE",
      "started_at": 1517431730064,
      "ended_at": 1517431732978,
      "_stats": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/stats",
      "_stats_details": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/stats/details",
      "_shots": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/shots",
      "_locations": [
        "https://api-shottracker.ddsports.com/v1/data/sensors/locations?id=23d3344b-06c8-11e8-bb65-0242286dfad2&from=1517431730064&to=1517431732978"
      ],
      "_possessions": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/possessions",
      "_possessions_summary": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/possessions/summary"
    }
  ],
  "is_practice_event": true,
  "is_game_event": false,
  "started_at": 1517430299810,
  "ended_at": 1517431732978,
  "_self": "https://api-shottracker.ddsports.com/v1/data/teams/12345/practices/cf3ba789-06c4-11e8-bb65-0242286dfad2"
}

Content-Type: application/json

{
  "status": 404,
  "message": "practice event not found",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 500,
  "message": "<General System Error Message>",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "id": "cf3ba789-06c4-11e8-bb65-0242286dfad2",
  "name": "TeamAppTeam vs TestTeamAlpha",
  "results": [
    {
      "id": "cf56d0aa-06c4-11e8-bb65-0242286dfad2",
      "name": null,
      "type": "GAME_ROUND",
      "started_at": 1517430299810,
      "ended_at": 1517431728868,
      "_stats": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/stats",
      "_stats_details": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/stats/details",
      "_shots": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/shots",
      "_locations": [
        "https://api-shottracker.ddsports.com/v1/data/sensors/locations?id=cf56d0aa-06c4-11e8-bb65-0242286dfad2&from=1517430299810&to=1517431728868"
      ],
      "_possessions": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/possessions",
      "_possessions_summary": "https://api-shottracker.ddsports.com/v1/data/stats/cf56d0aa-06c4-11e8-bb65-0242286dfad2/possessions/summary"
    },
    {
      "id": "23d3344b-06c8-11e8-bb65-0242286dfad2",
      "name": null,
      "type": "GAME_ROUND",
      "started_at": 1517431730064,
      "ended_at": 1517431732978,
      "_stats": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/stats",
      "_stats_details": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/stats/details",
      "_shots": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/shots",
      "_locations": [
        "https://api-shottracker.ddsports.com/v1/data/sensors/locations?id=23d3344b-06c8-11e8-bb65-0242286dfad2&from=1517431730064&to=1517431732978"
      ],
      "_possessions": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/possessions",
      "_possessions_summary": "https://api-shottracker.ddsports.com/v1/data/stats/23d3344b-06c8-11e8-bb65-0242286dfad2/possessions/summary"
    }
  ],
  "is_practice_event": false,
  "is_game_event": true,
  "started_at": 1517430299810,
  "ended_at": 1517431732978,
  "game_type": "HALF",
  "_self": "https://api-shottracker.ddsports.com/v1/data/games/cf3ba789-06c4-11e8-bb65-0242286dfad2",
  "totals": {
    "_stats_details": "https://api-shottracker.ddsports.com/v1/data/stats/games/cf3ba789-06c4-11e8-bb65-0242286dfad2/stats/details"
  },
  "reference_id": "8c6cdaf4-b4dd-11ec-a865-02a7227af969",
  "game_attributes": {
    "home_team_id": 461,
    "home_team_name": "TeamAppTeam",
    "away_team_id": 469,
    "away_team_name": "TestTeamAlpha"
  }
}

Content-Type: application/json

{
  "status": 404,
  "message": "game event not found",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 500,
  "message": "<General System Error Message>",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "player_ids": [
    "123",
    "456",
    "789"
  ]
}

Content-Type: application/json

{
  "status": 400,
  "message": "Parameter 'at' must be greater than 0 | Parameter 'at' is invalid",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 403,
  "message": "Restricted resource",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 404,
  "message": "Game not found",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 500,
  "message": "<General System Error Message>",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "sensor_assignments_history": [
    {
      "sensor_id": "456",
      "player_id": "123",
      "team_id": "461",
      "timestamp": 1620135099
    }
  ]
}

Content-Type: application/json

{
  "status": 403,
  "message": "Restricted resource",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 404,
  "message": "Game not found",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 500,
  "message": "<General System Error Message>",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "action": "<selected action>"
}

Content-Type: application/json

{"response":{“action”:”<requested action>”,“data”:<variable response based on action>}}

Content-Type: application/json

{
  "status": 403,
  "message": "Restricted resource",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 404,
  "message": "Game not found",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Content-Type: application/json

{
  "status": 500,
  "message": "<General System Error Message>",
  "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
}

Live Data V2 ¶

All live data is delivered over a websocket, a long lived connection between the DDSports servers and the client application. All websockets require a subscription token which is first obtained by subscripting to the specific game or practice drill.

Important: Websocket tokens are issued for the specific game or drill. A new token must be obtained to subscribe to another game or practice drill.

Connection Request ¶

wss://api-shottracker.ddsports.com/live/v2/games?token=[subscription token]&source=[source]&broadcast_summary_level=[summary level]&last_seq=[sequence number]

Query Parameters

Keep Alives ¶

Clients must send a ping request every minute to ensure the connection stays open when no data is received. The server will send back a corresponding pong response.

• Ping Request (application/json)

  {"action":"ping"}

• Pong Response (application/json)

  {"action":"pong"}

Sources ¶

Marker Source ¶

Game Status Markers

• Example marker (application/json)

  {"seq":"5","type":"data","source":"marker","data":{"t":1665763312858,"gameId":"f29b2985-4bd7-11ed-9596-0242e9e2912e","status":"PLAY_START"}}

Game State Markers

• Example marker (application/json)

  {"seq":"5","type":"data","source":"marker","data":{"t":1676998850203,"gameId":"45a64b38-b205-11ed-b27e-0242e9e2912e","status":"LIVE"}}

Game Lineup Markers

The ShotTracker system uses auto detection for active players who are on court in practice scrimmages and games.

The lineup message will contain the following status:

• Example marker (application/json)

  {"seq":"5","type":"data","source":"marker","data":{"t":1676998850359,"gameId":"45a64b38-b205-11ed-b27e-0242e9e2912e","status":"LINEUP","data":{"gameId":"45a64b38-b205-11ed-b27e-0242e9e2912e","sessionId":"46408f6c-b205-11ed-b27e-0242e9e2912e","pid":"7091","status":"ADDED"}}}

Game Jersey Color Markers

When a game starts or while the game is running, an update will be sent when the jersey colors for the teams are initially set or changed. This will typically only happen before play starts but should be considered if the consumer subscribes to the game before it is started.

• Example marker (application/json)

  {"seq":"5","type":"data","source":"marker","data":{"t":1676998226493,"gameId":"45a64b38-b205-11ed-b27e-0242e9e2912e","status":"JERSEY_COLOR","data":{"facilityId":"35f20157-ee24-11e9-bcab-06a15c73f3c3","courtId":"5dd7ff0b-ee24-11e9-bcab-06a15c73f3c3","gameId":"45a64b38-b205-11ed-b27e-0242e9e2912e","status":"JERSEY_COLOR_UPDATED","team1Id":552,"team1JerseyColor":"0000FF","team2Id":526,"team2JerseyColor":"FFFB00"}}}

Broadcast Summary Source ¶

• Example broadcastsummary (application/json)

  {"type":"data","source":"broadcastsummary","data":{"<see broadcast api>"}}

Boxscore Stats Version 2 Source ¶

• Example boxscorestatsv2 (application/json)

  {"seq":"25","type":"data","source":"boxscorestatsv2","data":{"classification":"THREE_POINT_MAKE","act":"PLAYER","eid":"43d32b49-39c0-11ed-abe8-0242e9e2912e","tid":"526","st":"GAME_ROUND","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","t":1663773345277,"gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","stats":{"FG":1.0,"OPPOSING_TEAM_SCORE":2.0,"FGA_CAS":1.0,"GAME_LEAD_CHANGES":2.0,"TEAM_SCORE":5.0,"PTS":3.0,"FG3":1.0,"FG3_CAS":1.0,"FG_CAS":1.0,"FGA3":1.0,"FG_STREAK":1.0,"FGA3_CAS":1.0,"FGA":1.0},"totalStats":{"FG":1.0,"OPPOSING_TEAM_SCORE":2.0,"FGA_CAS":1.0,"GAME_LEAD_CHANGES":2.0,"TEAM_SCORE":5.0,"PTS":3.0,"FG3":1.0,"FG3_CAS":1.0,"FG_CAS":1.0,"FGA3":1.0,"FG_STREAK":1.0,"FGA3_CAS":1.0,"FGA":1.0},"v":143,"c":false,"gc":null,"sc":null,"prd":"Q1","px":-6467,"py":-13317,"hex":-6513,"hey":-751,"pid":"7088"}}

Chart Source ¶

• Example chart (application/json)

  {"seq":"26","type":"data","source":"chart","data":{"label":null,"eid":"43d32b49-39c0-11ed-abe8-0242e9e2912e","t":1663773345277,"pid":"7088","tid":"526","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","sst":"GAME_ROUND","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","st":"MAKE","is3":true,"pts":3,"z":14,"az":22,"px":-6467,"py":-13317,"pz":30,"hx":46,"hy":-12566,"hz":2990,"hsx":-6513,"hsy":-751,"s":"RECORDED","drb":0,"dd":null,"fid":"35f20157-ee24-11e9-bcab-06a15c73f3c3","hid":"7332db6d-ee25-11e9-bcab-06a15c73f3c3","gc":null,"sc":null,"prd":"Q1","attributes":["CAS"],"players":["7088","7089","7090","7091","7092","7093","7096","7097","7098","7099","7288"],"d":655.615512324106,"shotDefenders":[7092]}}

Possessions Source ¶

• Example possessions (application/json)

  {"seq":"30","type":"data","source":"possessions","data":{"state":"SAVED","possession":{"supervision":"SYSTEM","startTimestamp":1663773326618,"teamId":"526","lineupName":"ONE","sessionId":"4c298764-39bf-11ed-bbae-0242e9e2912e","practiceId":null,"drillDefinitionId":null,"practiceDefinitionId":null,"gameId":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","lineupPlayers":["7089","7088","7097","7091","7092"],"opponentLineupPlayers":["7271","7273","7265","7269","7263"],"screenPlayers":[],"corrected":false,"deleted":false,"version":1,"startGameClock":null,"period":"Q1","facilityId":"35f20157-ee24-11e9-bcab-06a15c73f3c3","courtId":"5dd7ff0b-ee24-11e9-bcab-06a15c73f3c3","possessions":[{"sessionId":"4c298764-39bf-11ed-bbae-0242e9e2912e","teamId":"526","playerId":"7092","lineup":"ONE","possessionType":"DEFENSIVE_REB","3Point":false,"shotDistance":0.0,"x":0,"y":0,"z":0,"zone":0,"advancedZone":0,"timestamp":1663773326618,"gameClock":null,"shotClock":null,"scoring":false,"nonScoring":true},{"sessionId":"4c298764-39bf-11ed-bbae-0242e9e2912e","teamId":"526","playerId":"7089","lineup":"ONE","possessionType":"AST","3Point":false,"shotDistance":0.0,"x":0,"y":0,"z":0,"zone":0,"advancedZone":0,"timestamp":1663773345276,"gameClock":null,"shotClock":null,"scoring":false,"nonScoring":true},{"sessionId":"4c298764-39bf-11ed-bbae-0242e9e2912e","teamId":"526","playerId":"7088","lineup":"ONE","possessionType":"FG","3Point":true,"shotDistance":0.0,"x":0,"y":0,"z":0,"zone":0,"advancedZone":0,"timestamp":1663773345277,"gameClock":null,"shotClock":null,"scoring":true,"nonScoring":false}],"shotDistance":[0.0],"resultedStats":{},"id":"baa97fee-6858-43dd-ad2d-2c99dcf25e78","possessionTime":18659,"endTimestamp":1663773345277,"endPossession":{"present":true},"locationsPreview":[],"stats":{"turnover":0,"shotType":3,"shotValue":3,"points":3,"passes":3,"halfCourt":true,"paintTouch":false,"ballReversals":1,"ballScreens":0,"ballScreensLeftWing":0,"ballScreensMiddleWing":0,"ballScreensRightWing":0,"ballScreensPickAndPop":0,"ballScreensPickAndRoll":0,"ballScreensPickAndShortRoll":0,"ballScreensScreenedShot":0,"ballScreensHandoff":0,"ballScreensDrag":0,"ballScreensPop":0,"ballScreensRoll":0,"ballScreensSlip":0,"ballScreensShortRoll":0,"ballScreensReject":0,"ballScreensReScreen":0,"ballScreensStay":0,"ballScreensStepUp":0,"ballScreensSnake":0,"ballScreensSplit":0,"ballScreensOther":0},"endGameClock":null,"clipId":null,"videoAttributes":{"facilityId":"35f20157-ee24-11e9-bcab-06a15c73f3c3","courtId":"5dd7ff0b-ee24-11e9-bcab-06a15c73f3c3","sessionId":"4c298764-39bf-11ed-bbae-0242e9e2912e"},"manuallySupervised":false,"scoring":true,"nonScoring":false,"fieldGoalShotType":3,"valid":true},"responseView":{"id":"baa97fee-6858-43dd-ad2d-2c99dcf25e78","teamId":"526","sessionId":"4c298764-39bf-11ed-bbae-0242e9e2912e","gameId":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","startTimestamp":1663773326618,"endTimestamp":1663773345277,"possessionTimeMs":18659,"possessionTimeSeconds":18,"possessions":[{"timestamp":1663773326618,"possessionType":"DEFENSIVE_REB","playerId":"7092","actorType":"PLAYER","lineup":"ONE","x":0,"y":0,"z":0,"is3Point":false},{"timestamp":1663773345276,"possessionType":"AST","playerId":"7089","actorType":"PLAYER","lineup":"ONE","x":0,"y":0,"z":0,"is3Point":false},{"timestamp":1663773345277,"possessionType":"FG","playerId":"7088","actorType":"PLAYER","lineup":"ONE","x":0,"y":0,"z":0,"is3Point":true}],"shotDistanceCm":[0.0],"shotDistanceFt":[0],"locationsPreview":[],"period":"Q1","events":{"turnover":0,"shotType":3,"shotValue":3,"points":3,"passes":3,"halfCourt":true,"paintTouch":false,"ballReversals":1,"ballScreens":0,"ballScreensLeftWing":0,"ballScreensMiddleWing":0,"ballScreensRightWing":0,"ballScreensPickAndPop":0,"ballScreensPickAndRoll":0,"ballScreensPickAndShortRoll":0,"ballScreensScreenedShot":0,"ballScreensHandoff":0,"ballScreensDrag":0,"ballScreensPop":0,"ballScreensRoll":0,"ballScreensSlip":0,"ballScreensShortRoll":0,"ballScreensReject":0,"ballScreensReScreen":0,"ballScreensStay":0,"ballScreensStepUp":0,"ballScreensSnake":0,"ballScreensSplit":0,"ballScreensOther":0},"lineupPlayers":[7089,7088,7097,7091,7092],"opponentLineupPlayers":[7271,7273,7265,7269,7263]}}}

Possession Stats Source ¶

• Example possessionstats (application/json)

  {"seq":"33","type":"data","source":"possessionstats","data":{"t":1663773345456,"scope":"SESSION","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","st":"GAME_ROUND","tid":"526","summary":[{"type":"OVERALL","POSS":4,"POSS_PCT":80.0,"PTS":5,"PPP":1.25,"2PTM":1,"2PTA":1,"2PT_PCT":100.0,"3PTM":1,"3PTA":2,"3PT_PCT":50.0,"TO":1,"TO_PCT":25.0,"EFG":83.0},{"type":"PT0_BR0","POSS":2,"POSS_PCT":50.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":1,"3PT_PCT":0.0,"TO":1,"TO_PCT":50.0,"EFG":0.0},{"type":"PT1_BR0","POSS":1,"POSS_PCT":25.0,"PTS":2,"PPP":2.0,"2PTM":1,"2PTA":1,"2PT_PCT":100.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":100.0},{"type":"PT0_BR1","POSS":1,"POSS_PCT":25.0,"PTS":3,"PPP":3.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":1,"3PTA":1,"3PT_PCT":100.0,"TO":0,"TO_PCT":0.0,"EFG":150.0},{"type":"PT0_BR2","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"PT1_BR1","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"PT1_BR2","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"TRANSITION","POSS":1,"POSS_PCT":20.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":1,"TO_PCT":100.0,"EFG":0.0},{"type":"PASS0_2","POSS":3,"POSS_PCT":75.0,"PTS":2,"PPP":0.67,"2PTM":1,"2PTA":1,"2PT_PCT":100.0,"3PTM":0,"3PTA":1,"3PT_PCT":0.0,"TO":1,"TO_PCT":33.3,"EFG":50.0},{"type":"PASS3_5","POSS":1,"POSS_PCT":25.0,"PTS":3,"PPP":3.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":1,"3PTA":1,"3PT_PCT":100.0,"TO":0,"TO_PCT":0.0,"EFG":150.0},{"type":"PASS6","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS0","POSS":5,"POSS_PCT":100.0,"PTS":5,"PPP":1.0,"2PTM":1,"2PTA":1,"2PT_PCT":100.0,"3PTM":1,"3PTA":2,"3PT_PCT":50.0,"TO":2,"TO_PCT":40.0,"EFG":83.0},{"type":"BS_ALL","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS1","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS2","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS3","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_LW","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_MW","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_RW","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_PNP","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_PNR","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_SS","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_HANDOFF","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_DRAG","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_SLIP","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_SHORT_ROLL","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_REJECT","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_RE_SCREEN","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_STAY","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_STEP_UP","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_SNAKE","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_SPLIT","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0},{"type":"BS_OTHER","POSS":0,"POSS_PCT":0.0,"PTS":0,"PPP":0.0,"2PTM":0,"2PTA":0,"2PT_PCT":0.0,"3PTM":0,"3PTA":0,"3PT_PCT":0.0,"TO":0,"TO_PCT":0.0,"EFG":0.0}]}}

Lineup Stats Source ¶

• Example lineupstats (application/json)

  {"seq":"31","type":"data","source":"lineupstats","data":{"tid":"526","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","stats":{"FG_RATE":66.67,"REB_RATE":50.0,"TOTAL_POINTS_SCORED":5.0,"TOTAL_TURNOVERS":2.0,"TOTAL_OFFENSIVE_POSSESSIONS":7.0,"DEF_FG_RATE":25.0,"DPPP":0.29,"AST_RATE":100.0,"TO_RATE":28.57,"TOTAL_DEFENSIVE_POSSESSIONS":7.0,"PPP":0.42,"OPPP":0.71,"PLUS_MINUS":3.0,"TOTAL_POINTS_ALLOWED":2.0,"FG3_RATE":50.0},"players":["7088","7089","7091","7092","7097"]}}

Location Source ¶

• Example location (application/json)

  {"type":"data","source":"location","data":{"gcms":0,"scms":0,"cr":false,"period":"Q1","facilityId":"35f20157-ee24-11e9-bcab-06a15c73f3c3","courtId":"5dd7ff0b-ee24-11e9-bcab-06a15c73f3c3","sessionId":"4c298764-39bf-11ed-bbae-0242e9e2912e","locations":[{"t":1663773891625,"tag":"200003","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7089,"tid":526,"x":-9084,"y":1117,"z":138,"speed":0.777628,"dist":0.92102,"vx":-0.576889,"vy":-0.232025,"vz":0.129625},{"t":1663773891625,"tag":"200002","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7288,"tid":526,"x":-133,"y":-8847,"z":95,"speed":3.353453,"dist":0.529648,"vx":3.215284,"vy":-0.397222,"vz":0.065104},{"t":1663773891625,"tag":"200024","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7274,"tid":552,"x":-8294,"y":-15242,"z":322,"speed":0.196576,"dist":0.165341,"vx":-0.043643,"vy":0.058021,"vz":0.093917},{"t":1663773891625,"tag":"200021","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7271,"tid":552,"x":-7535,"y":-16712,"z":0,"speed":0.203159,"dist":0.940941,"vx":0.015162,"vy":0.073334,"vz":-0.021697},{"t":1663773891625,"tag":"200023","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7273,"tid":552,"x":-8595,"y":-12440,"z":6,"speed":0.451124,"dist":0.750029,"vx":-0.08,"vy":-0.07458,"vz":-0.120639},{"t":1663773891625,"tag":"200004","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7090,"tid":526,"x":1559,"y":-2384,"z":45,"speed":0.317927,"dist":0.523592,"vx":-0.011481,"vy":-0.141197,"vz":0.040384},{"t":1663773891625,"tag":"200020","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7270,"tid":552,"x":-8913,"y":-13879,"z":228,"speed":0.500529,"dist":0.134989,"vx":-0.046544,"vy":-0.222355,"vz":0.260521},{"t":1663773891625,"tag":"200011","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7099,"tid":526,"x":-9141,"y":13619,"z":427,"speed":0.2988,"dist":0.210371,"vx":-0.165552,"vy":0.026651,"vz":0.022272},{"t":1663773891625,"tag":"200001","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7088,"tid":526,"x":-8799,"y":11076,"z":137,"speed":0.483392,"dist":0.978312,"vx":0.099216,"vy":-0.12158,"vz":0.061723},{"t":1663773891625,"tag":"200017","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7265,"tid":552,"x":995,"y":-4705,"z":370,"speed":0.403067,"dist":0.823304,"vx":0.030394,"vy":0.05128,"vz":-0.166337},{"t":1663773891625,"tag":"200014","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7261,"tid":552,"x":4451,"y":-10148,"z":351,"speed":0.332753,"dist":0.363516,"vx":-0.089798,"vy":-2.67E-4,"vz":-0.1516},{"t":1663773891625,"tag":"200022","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7272,"tid":552,"x":-8806,"y":-14846,"z":0,"speed":0.443454,"dist":0.199899,"vx":-0.098755,"vy":0.004689,"vz":-0.0},{"t":1663773891625,"tag":"200012","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7259,"tid":552,"x":-8864,"y":-11741,"z":0,"speed":0.404919,"dist":0.688971,"vx":0.019898,"vy":0.083356},{"t":1663773891625,"tag":"200019","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7269,"tid":552,"x":-1242,"y":-9487,"z":76,"speed":1.925896,"dist":1.020535,"vx":1.462376,"vy":-0.376558,"vz":0.045931},{"t":1663773891625,"tag":"200018","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7267,"tid":552,"x":-9728,"y":-14671,"z":557,"speed":0.14137,"dist":0.164881,"vx":-0.027158,"vy":0.04874,"vz":-0.068781},{"t":1663773891625,"tag":"200013","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7260,"tid":552,"x":-464,"y":-7131,"z":234,"speed":1.001474,"dist":0.855718,"vx":-0.014116,"vy":-0.37648,"vz":0.168946},{"t":1663773891625,"tag":"200016","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7263,"tid":552,"x":330,"y":-7954,"z":311,"speed":0.569265,"dist":0.765461,"vx":0.260113,"vy":0.007804,"vz":0.239178},{"t":1663773891625,"tag":"200015","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7262,"tid":552,"x":-9017,"y":-12204,"z":1147,"speed":0.958868,"dist":0.126015,"vx":-0.251233,"vy":0.735995,"vz":0.701144},{"t":1663773891625,"tag":"200010","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7098,"tid":526,"x":-8738,"y":12785,"z":528,"speed":0.146344,"dist":0.26941,"vx":-0.02187,"vy":-0.01748,"vz":-0.038595},{"t":1663773891625,"tag":"200009","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7097,"tid":526,"x":1191,"y":-7233,"z":190,"speed":0.520334,"dist":1.172094,"vx":0.057488,"vy":0.017637,"vz":-0.096307},{"t":1663773891625,"tag":"200008","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7096,"tid":526,"x":-883,"y":-6343,"z":394,"speed":1.472018,"dist":0.48701,"vx":-0.561989,"vy":-0.674352,"vz":-1.026403},{"t":1663773891625,"tag":"200005","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7091,"tid":526,"x":6984,"y":-11868,"z":256,"speed":0.703452,"dist":1.210522,"vx":-0.022807,"vy":-0.024237,"vz":0.128032},{"t":1663773891625,"tag":"200007","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7093,"tid":526,"x":-9157,"y":14063,"z":1,"speed":0.520848,"dist":0.223269,"vx":0.100052,"vy":0.021815,"vz":-0.051862},{"t":1663773891625,"tag":"200006","sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"PLAYER","pid":7092,"tid":526,"x":-9121,"y":12061,"z":404,"speed":0.294251,"dist":1.02405,"vx":-0.004419,"vy":0.015697,"vz":0.037251},{"t":1663773891625,"sid":"4c298764-39bf-11ed-bbae-0242e9e2912e","gid":"4bb6ef73-39bf-11ed-bbae-0242e9e2912e","type":"BALL","bid":"2147568693","x":1073,"y":-2675,"z":1195,"speed":0.935029,"vx":0.458586,"vy":-0.814848,"vz":-0.277803}]}}

Clock Source ¶

The clock message is automatically emitted for games only.

The clock message will contain the following period labels:

The clock message will contain the following types:

The clock message will contain the following sources:

• Example clock (application/json)

  {"type":"data","source":"clock","data":{"gid":"f29b2985-4bd7-11ed-9596-0242e9e2912e","period":"OT","type":"GAME_SHOT_CLOCK","state":"STARTED","source":"OFFICIAL","min":"81","sec":"53","subSec":"0","shotSec":null,"shotSubSec":null,"controllerId":null}}

Live Data V1 **DEPRECATED** ¶

NOTICE: live data v1 is documented for legacy support and will eventually be deprecated. All new developement should be done using the live data v2

All live data is delivered over a websocket, a long lived connection between the DDSports servers and the client application. All websockets require a subscription token which is first obtained by subscripting to the specific game or practice drill.

Important: Websocket tokens are issued for the specific game or drill. A new token must be obtained to subscribe to another game or practice drill.

Connection Request ¶

ws://live.shottracker.com?token=[subscription token]

Example Connection Response ¶

• Ack Response (application/json)

  {"data":{"socketSessionId":"2edbccd1","serverAttributes":{"maxInputBufferSizeInBytes":8192,"connectionTimeoutInMs":120000}},"action":"subscribe","type":"ack"}

Keep Alives ¶

The Ack response indicates how long the connection will stay open before timing out when no data is traveling over the connection (connectionTimeoutInMs). Clients should send a ping request to ensure the connection stays open when no data is received. The server will send back a corresponding pong response.

• Ping Request (application/json)

  {"action":"ping"}

• Pong Response (application/json)

  {"action":"pong"}

Data Type Responses ¶

• Stats Response (application/json)

  {"type":"stats","data":{"occurred_at":1484865816836,"team_id":461,"player_id":123,"stats":{"FGA":4.0,"PTS":4.0,"FG":2.0},"event_total_stats":{"FGA":8.0,"PTS":6.0,"FG":3.0},"classification":"TWO_POINT_MAKE","version":317,"game_clock":"1:2.3","shot_clock":"4.5","period":"Q1"}}

• Shots Response (application/json)

  {"type":"shot","data":{"occurred_at":1484865816836,"team_id":461,"player_id":123,"is_make":true,"is_3point":true,"zone":1,"advanced_zone":2,"hoop_x":10,"hoop_y":11669,"hoop_player_x":12,"hoop_player_y":3,"status":"RECORDED","game_clock":"1:2.3","shot_clock":"4.5","period":"Q1","attributes":["JUMPSHOT"]}}

• Location Response (application/json)

  {"type":"location","data":{"locations":[{"occurred_at":1478800197342,"type":"PLAYER","id":123,"x":123,"y":456,"z":789,"speed":0.1,"dist":1.3,"vx":1.2,"vy":3.4,"vz":5.6},{"occurred_at":1478800197342,"type":"PLAYER","id":456,"x":456,"y":789,"z":123,"speed":0.1,"dist":1.3,"vx":1.2,"vy":3.4,"vz":5.6},{"occurred_at":1478800197342,"type":"BALL","id":9456,"x":456,"y":789,"z":123,"speed":0.2,"vx":1.2,"vy":3.4,"vz":5.6},{"occurred_at":1478800197342,"type":"OFFICIAL","id":789,"x":123,"y":456,"z":789,"speed":0.1,"dist":1.3,"vx":1.2,"vy":3.4,"vz":5.6}]}}

• Possession Response (application/json)

  {"type":"possession","data":{"state":"SAVED","possession":{"stats":[{"timestamp":1638481004439,"possession_type":"LBTO","player_id":1,"game_clock":"12:34.5","shot_clock":"09.1"}],"start_timestamp":1638481003439,"end_timestamp":1638481004439,"team_id":1,"player_ids":[1,2,3,4,5],"opposing_player_ids":[6,7,8,9,10],"start_game_clock":"12:34.5","end_game_clock":"12:34.5","period":"Q1","possession_attributes":{"turnover":1,"passes":5,"half_court":true,"paint_touch":false,"ball_reversals":6,"ball_screens":7,"ball_screens_left_wing":8,"ball_screens_middle_wing":9,"ball_screens_right_wing":10,"ball_screens_pick_n_pop":11,"ball_screens_pick_n_roll":12,"ball_screens_pick_n_short_roll":13,"ball_screens_screened_shot":14,"ball_screens_handoff":15,"ball_screens_drag":16,"ball_screens_pop":0,"ball_screens_roll":0,"ball_screens_slip":0,"ball_screens_short_roll":0,"ball_screens_reject":0,"ball_screens_re_screen":0,"ball_screens_stay":0,"ball_screens_step_up":0,"ball_screens_snake":0,"ball_screens_split":0,"ball_screens_other":0}}}}

Marker Type Responses ¶

Markers are multi-purpose messages emitted to indicate the period change in games or drill changes in practice, updates in game to jersey colors or which players are currently active on the floor. Some marker messages contain an additional data field depending on their type; the PLAY_NEXT and DRILL_NEXT markers are the exception to this rule.

Game State Markers ¶

Game Status Markers

• Example marker (application/json)

  {"seq":"5","type":"data","source":"marker","data":{"t":1665763312858,"gameId":"f29b2985-4bd7-11ed-9596-0242e9e2912e","status":"PLAY_START"}}

• Marker Response (application/json)

  {"type":"marker","data":{"occurred_at":1478800197300,"type":"<data value>"}}

If subscribing to the live_id the following marker will be sent to indicate the next live id.

• Play Next Marker Response (application/json)

  {"type":"marker","data":{"occurred_at":1478800197339,"live_id":"a1140480-e1d5-4684-a619-402984b5c9ba","type":"PLAY_NEXT"}}

Game Jersey Color Marker ¶

When a game starts or while the game is running, an update will be sent when the jersey colors for the teams are initially set or changed. This will typically only happen before play starts but should be considered if the consumer subscribes to the game before it is started.

• Jersey Color Marker Response (application/json)

  {"type":"marker","data":{"occurred_at":1616535390628,"type":"JERSEY_COLOR","data":{"teams":[{"id":461,"color":"0DDAFF"},{"id":493,"color":"00FF09"}]}}}

Practice State Markers ¶

Practice Marker Descriptions

• Marker Response (application/json)

  {"type":"marker","data":{"occurred_at":1478800197300,"type":"<data value>"}}

System State Markers ¶

Game State Markers

• Example marker (application/json)

  {"seq":"5","type":"data","source":"marker","data":{"t":1676998850203,"gameId":"45a64b38-b205-11ed-b27e-0242e9e2912e","status":"LIVE"}}

• Marker Response (application/json)

  {"type":"marker","data":{"occurred_at":1478800197300,"type":"<data value>"}}

Lineup Detection Marker ¶

Game Lineup Markers

The ShotTracker system uses auto detection for active players who are on court in practice scrimmages and games.

The lineup message will contain the following status:

• Example marker (application/json)

  {"seq":"5","type":"data","source":"marker","data":{"t":1676998850359,"gameId":"45a64b38-b205-11ed-b27e-0242e9e2912e","status":"LINEUP","data":{"gameId":"45a64b38-b205-11ed-b27e-0242e9e2912e","sessionId":"46408f6c-b205-11ed-b27e-0242e9e2912e","pid":"7091","status":"ADDED"}}}

• Lineup Marker Response (application/json)

  {"type":"marker","data":{"occurred_at":1616535390628,"type":"LINEUP","data":{"player_id":123456,"status":"<Status>"}}}

Game Clock Response ¶

The clock message is automatically emitted for games only.

The clock message will contain the following period labels:

The clock message will contain the following types:

The clock message will contain the following sources:

The clock message contains both the game and shot clock values. Each clock is broken down to the specific minutes (min), seconds (sec) and sub seconds (sub_sec) values. The values can return as null; specifically the sub_sec. In the event a clock is not detected the object will be empty: example “shot_clock”:{}.

• Response (application/json)

  {"type":"clock","data":{"period":"H1","type":"GAME_SHOT_CLOCK","game_clock":{"min":"9","sec":"39","sub_sec":null},"shot_clock":{"sec":"12","sub_sec":null}}}

Teams ¶

Content-Type: application/json

{
  "teams": [
    {
      "id": 46,
      "name": "Test Team",
      "gender": "MEN",
      "conference_name": "ACC",
      "league_name": "NCAA",
      "sport": "BASKETBALL",
      "reference_id": "938104592"
    }
  ]
}