List an event's players

The event’s team rosters. A roster is the team’s current roster, not the game-day actives, and is cached for up to 15 minutes. teams is empty when the event’s type offers no player props or its rosters are not published yet. A player’s player_id is what POST /api/v1/markets takes. stats lists the stats on offer for this event, as GET /api/v1/types does per event type.

GET

https://demo.stxapp.iohttps://demo.stxapp.cahttps://api.on.stxapp.ca/api/v1/events/{event_id}/players

For apps

Call it with an OAuth app token (client_credentials) carrying events. See Creating markets.

In the SDKs

• TypeScript: STX.eventPlayers()
• Python: STX.event_players()
• C#: STXClient.GetEventPlayersAsync()

Parameters

Name	In	Type	Required	Description
event_id	path	string (uuid)	yes	The event’s UUID.

Responses

Status	Description	Schema
200	Success	object
400	A parameter was missing or invalid.	Error
401	No credential, a bad signature or an invalid OAuth access token. Body: {“error”:“Missing or invalid API key credentials”}, or for an OAuth token {“error”:“Missing or invalid OAuth access token”}.	Error
403	An OAuth app token without the events scope. The account behind this key is not active, for example it is pending approval or suspended. Body: {“error”:“Your account is suspended. Contact support.”}, the message naming the account’s status.	Error
404	No such event.	Error

Example

Request:

curl --request GET \
  --url 'https://demo.stxapp.io/api/v1/events/{event_id}/players' \
  --header 'Authorization: Bearer <app-access-token>'

Response 200:

{
  "event_id": "24636b3d-f566-4dd3-8c8b-c1a6c2747789",
  "stats": [
    {
      "name": "Total Assists",
      "stat": "ASSISTS"
    },
    {
      "name": "Goals",
      "stat": "GOALS"
    },
    {
      "name": "Shots on Goal",
      "stat": "GOAL_SO"
    },
    {
      "name": "Total Points",
      "stat": "POINTS"
    },
    {
      "name": "Total Saves",
      "stat": "SAVES"
    }
  ],
  "teams": [
    {
      "players": [
        {
          "jersey": "97",
          "name": "Connor McDavid",
          "player_id": "3895074",
          "position": "C"
        },
        {
          "jersey": "2",
          "name": "Evan Bouchard",
          "player_id": "4352722",
          "position": "D"
        },
        {
          "jersey": "29",
          "name": "Leon Draisaitl",
          "player_id": "3114727",
          "position": "C"
        }
      ],
      "team": "Edmonton Oilers"
    },
    {
      "players": [
        {
          "jersey": "71",
          "name": "Macklin Celebrini",
          "player_id": "5206628",
          "position": "C"
        },
        {
          "jersey": "73",
          "name": "Tyler Toffoli",
          "player_id": "5550",
          "position": "C"
        }
      ],
      "team": "San Jose Sharks"
    }
  ]
}

Response fields

Field	Type	Description
event_id	uuid	The event.
name	string	The stat’s name.
stat	string	The stat key an entry takes.