# Player Statistics This endpoint is a live websocket endpoint that returns the full set up player hole statistics for all rounds in a given tournament. Currently the whole player stats event is sent whenever a new RoundDetails packet is received from either FlightScope of PGA. The authentication token provided will be required to make a connection to this websocket endpoint. Once you have the API token, any further data that you send over the connection will be ignored. N.B – This endpoint sends heartbeats in-between data packets to let you know that it is still connected. This endpoint currently takes no request parameters ### **Endpoint URL** `wss://dde-streams.data.imgarena.com/media/golf/tournaments/{tournamentId}/playerstats` #### Note that the playerstats websocket is available via a RestAPI - This can be found at - `https://dde-streams.data.imgarena.com/media/golf/tournaments/{tournamentId}/playerstats` **Full list of Hole stats for each player** * **Holes** * drivingDistance * fairway * gir * holeNo * holedPuttDistance * bunker * putts * rough ### Player Hole Stats **Playerstats Object** | Field | Definition | Data Type | | --------------- | ------------------------------------ | ------------------------ | | SeqNum | Sequence number of the update packet | integer | | teamsStatistics | see object docs | object | | timestamp | Time the update is sent | time | | tournamentId | tournament ID | The id of the tournament | ``` { "seqNum": 2640, "teamsStatistics": [** see object below **], "timestamp": "2025-01-20T00:35:09.530Z", "tournamentId": 1092 } ``` **teamsStatistics Object** | Field | Definition | Data Type | | --------------- | ---------------------- | --------- | | players | see object docs | object | | teamsStatistics | see object docs | object | | teamId | team id for the player | integer | ``` "teamsStatistics": [ { "players": [** see object below **], "statistics": {** see object below **}, "teamId": 19 } ``` **players Object** | **Field Name** | Type | Description | | -------------- | ------- | ---------------------------- | | displayName | string | Name of the player | | Country | string | Country of the player | | isAmateur | boolean | True if player is an amateur | | lastName | string | Last name | | firstName | string | First name | | gender | string | gender of player | | id | integer | Player ID | ``` { "players": [ { "country": "ENG", "displayName": "Tyrrell Hatton", "firstName": "Tyrrell", "gender": "male", "id": 6, "isAmateur": false, "lastName": "Hatton" } ] ``` **holeStatistics Object** There is a subset of player stats that provides per round information about the player's performance on a limited number of statistics. These are as follows: | Field | Definition | Data Type | | ----------------- | ----------------------------------------------------------------------------------------------------------------- | --------- | | holeNo | The number of the hole | integer | | gir | Did the player make a Greens in Regulation. Defined as finding the Green or Hole on or before the (n-2)th stroke. | boolean | | holedPuttDistance | From what distance did a player hole out | float | | fairway | Did the player hit the fairway from the teeshot | boolean | | drivingDistance | Driving distance | float | | bunker | Did the player hit the bunker | boolean | | rough | Did the player hit the rough | boolean | | putts | Number of putts to hole the ball | integer | teamsStatistics sample json output: ``` { "players": [ { "country": "ITA", "displayName": " ", "firstName": "", "gender": "male", "id": 32, "isAmateur": false, "lastName": "" } ], "statistics": { "holeStatistics": [ { "holes": [ { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 1, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 2, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 3, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 4, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 5, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 6, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 7, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 8, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 9, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 10, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 11, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 12, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 13, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 14, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 15, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 16, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 17, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 18, "holedPuttDistance": 0, "putts": 0, "rough": false } ], "roundNo": 1 }, { "holes": [ { "bunker": false, "drivingDistance": 245.10701946240002, "fairway": true, "gir": false, "holeNo": 1, "holedPuttDistance": 0.14, "putts": 2, "rough": false }, { "bunker": false, "drivingDistance": 227.9372282496, "fairway": true, "gir": true, "holeNo": 2, "holedPuttDistance": 0.36, "putts": 2, "rough": false }, { "bunker": true, "drivingDistance": 250.31395614527997, "fairway": false, "gir": false, "holeNo": 3, "holedPuttDistance": 0.5, "putts": 2, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 4, "holedPuttDistance": 6.53, "putts": 1, "rough": false }, { "bunker": false, "drivingDistance": 264.38578502976003, "fairway": false, "gir": true, "holeNo": 5, "holedPuttDistance": 1.14, "putts": 1, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 6, "holedPuttDistance": 1.03, "putts": 1, "rough": false }, { "bunker": false, "drivingDistance": 218.00534902272, "fairway": true, "gir": true, "holeNo": 7, "holedPuttDistance": 3.89, "putts": 1, "rough": false }, { "bunker": false, "drivingDistance": 264.10578843456, "fairway": true, "gir": false, "holeNo": 8, "holedPuttDistance": 0.58, "putts": 2, "rough": false }, { "bunker": false, "drivingDistance": 268.19573870016, "fairway": true, "gir": true, "holeNo": 9, "holedPuttDistance": 0.47, "putts": 2, "rough": false }, { "bunker": false, "drivingDistance": 231.34018686912, "fairway": true, "gir": true, "holeNo": 10, "holedPuttDistance": 2.33, "putts": 1, "rough": false }, { "bunker": false, "drivingDistance": 282.03857036927997, "fairway": true, "gir": true, "holeNo": 11, "holedPuttDistance": 0.78, "putts": 2, "rough": false }, { "bunker": false, "drivingDistance": 224.63526840191997, "fairway": true, "gir": true, "holeNo": 12, "holedPuttDistance": 0.42, "putts": 2, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 13, "holedPuttDistance": 2.92, "putts": 1, "rough": false }, { "bunker": false, "drivingDistance": 257.90886379008003, "fairway": false, "gir": true, "holeNo": 14, "holedPuttDistance": 1.5, "putts": 2, "rough": false }, { "bunker": false, "drivingDistance": 271.29370102848, "fairway": true, "gir": false, "holeNo": 15, "holedPuttDistance": 13.42, "putts": 1, "rough": false }, { "bunker": false, "drivingDistance": 267.3067495104, "fairway": false, "gir": true, "holeNo": 16, "holedPuttDistance": 1.25, "putts": 2, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": true, "holeNo": 17, "holedPuttDistance": 0.61, "putts": 2, "rough": false }, { "bunker": false, "drivingDistance": 264.71578101696, "fairway": false, "gir": true, "holeNo": 18, "holedPuttDistance": 0.28, "putts": 2, "rough": false } ], "roundNo": 2 }, { "holes": [ { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 1, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 2, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 3, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 4, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 5, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 6, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 7, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 8, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 9, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 10, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 11, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 12, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 13, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 14, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 15, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 16, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 17, "holedPuttDistance": 0, "putts": 0, "rough": false }, { "bunker": false, "drivingDistance": 0, "fairway": false, "gir": false, "holeNo": 18, "holedPuttDistance": 0, "putts": 0, "rough": false } ], "roundNo": 3 } ] }, "teamId": 4 } ```