# Get Game Stats

Retrieves detailed play-by-play or drive-by-drive game statistics for a live sporting event. The response is a flat structure (wide table) containing fields for all sport types. Only fields relevant to the queried milestone's sport will be populated; others will be absent.

# OpenAPI definition

```json
{
  "info": {
    "title": "Webull Open API Reference",
    "description": "application.yml\\ncom\\ni18n\\nMETA-INF\\nstatic\\n\\r\\n",
    "contact": {
      "name": "",
      "url": "",
      "email": ""
    },
    "version": "2.0",
    "x-logo": {
      "url": "static/png/logo.png"
    }
  },
  "servers": [
    {
      "url": "https://us-global-openapi.uat.webullbroker.com"
    }
  ],
  "path": "/market-data/event-contracts/game-stats/get",
  "method": "get",
  "tags": [
    "Event Contract Market Data"
  ],
  "description": "Retrieves detailed play-by-play or drive-by-drive game statistics for a live sporting event. The response is a flat structure (wide table) containing fields for all sport types. Only fields relevant to the queried milestone's sport will be populated; others will be absent.",
  "operationId": "eventGameStatsUsingGET",
  "parameters": [
    {
      "name": "milestone_id",
      "in": "query",
      "description": "Milestone ID. A milestone represents a specific game or real-world occurrence tied to events.",
      "required": true,
      "schema": {
        "type": "string"
      },
      "example": "MS-NBA-20250514-LAL-BOS"
    },
    {
      "name": "category",
      "in": "query",
      "description": "Category, default is US_EVENT, currently only US_EVENT is supported.",
      "required": false,
      "schema": {
        "type": "string",
        "enum": [
          "US_EVENT"
        ],
        "default": "US_EVENT"
      },
      "example": "US_EVENT"
    },
    {
      "name": "access_token",
      "in": "header",
      "description": "User's authenticated token.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "reqid",
      "in": "header",
      "description": "The unique ID for this request. Suggest using UUID.",
      "schema": {
        "type": "string"
      },
      "example": "2e46d5a4-bef9-4507-8cda-98f85d2f770c"
    }
  ],
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "required": [
              "milestone_id"
            ],
            "type": "object",
            "properties": {
              "milestone_id": {
                "type": "string",
                "description": "Milestone ID",
                "example": "MS-NBA-20250514-LAL-BOS"
              },
              "periods": {
                "type": "array",
                "description": "Game periods/innings list",
                "items": {
                  "type": "object",
                  "properties": {
                    "period_number": {
                      "type": "integer",
                      "description": "Period/inning number",
                      "format": "int32",
                      "example": 1
                    },
                    "period_type": {
                      "type": "string",
                      "description": "Period type, e.g. quarter, top, bottom, period, half. Varies by sport.",
                      "example": "quarter"
                    },
                    "events": {
                      "type": "array",
                      "description": "Event list for this period",
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "description": "Event type identifier, e.g. football_drive, basketball_play, baseball_play, hockey_play, soccer_event.",
                            "example": "basketball_play"
                          },
                          "description": {
                            "type": "string",
                            "description": "Event description.",
                            "example": "LeBron James makes 3-point jump shot"
                          },
                          "attribution": {
                            "type": "string",
                            "description": "Attribution team/player ID.",
                            "example": "LAL-001"
                          },
                          "away_points": {
                            "type": "integer",
                            "description": "Away team points at this event.",
                            "format": "int32",
                            "example": 3
                          },
                          "home_points": {
                            "type": "integer",
                            "description": "Home team points at this event.",
                            "format": "int32",
                            "example": 0
                          },
                          "clock": {
                            "type": "string",
                            "description": "Game clock.",
                            "example": "11:24"
                          },
                          "possession": {
                            "type": "string",
                            "description": "Possession team ID.",
                            "example": "BOS-001"
                          },
                          "event_type": {
                            "type": "string",
                            "description": "Event sub-type (e.g. three_point_made, field_goal_made, goal, yellow_card). May appear in basketball, soccer.",
                            "example": "three_point_made"
                          },
                          "wall_clock": {
                            "type": "integer",
                            "description": "Event wall clock UTC timestamp in seconds. May appear in basketball.",
                            "format": "int64",
                            "example": 1778640099
                          },
                          "half": {
                            "type": "string",
                            "description": "Half inning indicator. May appear in baseball.",
                            "example": "top"
                          },
                          "strength": {
                            "type": "string",
                            "description": "Strength status, e.g. even/powerplay/shorthanded. May appear in hockey.",
                            "example": "powerplay"
                          },
                          "competitor": {
                            "type": "string",
                            "description": "Competitor side: home/away. May appear in soccer.",
                            "example": "home"
                          },
                          "match_time": {
                            "type": "integer",
                            "description": "Match time in minutes. May appear in soccer.",
                            "format": "int32",
                            "example": 22
                          },
                          "player_name": {
                            "type": "string",
                            "description": "Player name. May appear in soccer.",
                            "example": "Vinicius Jr"
                          },
                          "stoppage_time": {
                            "type": "integer",
                            "description": "Stoppage time in minutes. May appear in soccer.",
                            "format": "int32",
                            "example": 0
                          },
                          "def_points": {
                            "type": "integer",
                            "description": "Defensive points. May appear in football.",
                            "format": "int32",
                            "example": 0
                          },
                          "end_reason": {
                            "type": "string",
                            "description": "Drive end reason. May appear in football.",
                            "example": "touchdown"
                          },
                          "gain": {
                            "type": "integer",
                            "description": "Drive gain in yards. May appear in football.",
                            "format": "int32",
                            "example": 75
                          },
                          "off_points": {
                            "type": "integer",
                            "description": "Offensive points. May appear in football.",
                            "format": "int32",
                            "example": 7
                          },
                          "play_count": {
                            "type": "integer",
                            "description": "Number of plays in drive. May appear in football.",
                            "format": "int32",
                            "example": 8
                          },
                          "plays": {
                            "type": "array",
                            "description": "Play details list. May appear in football.",
                            "items": {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "description": "Play type identifier.",
                                  "example": "football_play"
                                },
                                "clock": {
                                  "type": "string",
                                  "description": "Game clock.",
                                  "example": "15:00"
                                },
                                "description": {
                                  "type": "string",
                                  "description": "Play description.",
                                  "example": "Jalen Hurts pass to A.J. Brown for 22 yards"
                                },
                                "down": {
                                  "type": "integer",
                                  "description": "Current down number.",
                                  "format": "int32",
                                  "example": 1
                                },
                                "yfd": {
                                  "type": "integer",
                                  "description": "Yards to first down.",
                                  "format": "int32",
                                  "example": 10
                                }
                              },
                              "description": "EventContractGameStatsPlayVo",
                              "title": "EventContractGameStatsPlayVo"
                            }
                          }
                        },
                        "description": "EventContractGameStatsEventVo",
                        "title": "EventContractGameStatsEventVo"
                      }
                    },
                    "period_name": {
                      "type": "string",
                      "description": "Period name. May appear in baseball, soccer.",
                      "example": "Top 1st"
                    },
                    "attribution": {
                      "type": "string",
                      "description": "Attribution team ID. May appear in baseball.",
                      "example": "NYY-001"
                    },
                    "half": {
                      "type": "string",
                      "description": "Half inning indicator. May appear in baseball.",
                      "example": "top"
                    },
                    "away_score": {
                      "type": "integer",
                      "description": "Away team current score. May appear in baseball, hockey, soccer.",
                      "format": "int32",
                      "example": 2
                    },
                    "away_team_id": {
                      "type": "string",
                      "description": "Away team ID. May appear in baseball, hockey, soccer.",
                      "example": "NYY-001"
                    },
                    "home_score": {
                      "type": "integer",
                      "description": "Home team current score. May appear in baseball, hockey, soccer.",
                      "format": "int32",
                      "example": 0
                    },
                    "home_team_id": {
                      "type": "string",
                      "description": "Home team ID. May appear in baseball, hockey, soccer.",
                      "example": "BOS-001"
                    }
                  },
                  "description": "EventContractGameStatsPeriodVo",
                  "title": "EventContractGameStatsPeriodVo"
                }
              }
            },
            "description": "EventContractGameStatsVo",
            "title": "EventContractGameStatsVo"
          }
        }
      }
    },
    "401": {
      "description": "Unauthorized: Authentication required",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error_code": {
                "type": "string",
                "description": "Internal logic error code"
              },
              "message": {
                "type": "string",
                "description": "Error message"
              }
            },
            "description": "ErrorResponseVo",
            "title": "ErrorResponseVo"
          },
          "example": {
            "error_code": "UNAUTHORIZED",
            "message": "Insufficient permission"
          }
        }
      }
    },
    "417": {
      "description": "A business logic error triggered when the request cannot be processed due to domain-specific constraints.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error_code": {
                "type": "string",
                "description": "Internal logic error code"
              },
              "message": {
                "type": "string",
                "description": "Error message"
              }
            },
            "description": "ErrorResponseVo",
            "title": "ErrorResponseVo"
          },
          "example": {
            "error_code": "UNSUPPORTED_CATEGORY",
            "message": "Unsupported category:US_EVENTS"
          }
        }
      }
    }
  },
  "postman": {
    "name": "Get Game Stats",
    "description": {
      "content": "Retrieves detailed play-by-play or drive-by-drive game statistics for a live sporting event. The response is a flat structure (wide table) containing fields for all sport types. Only fields relevant to the queried milestone's sport will be populated; others will be absent.",
      "type": "text/plain"
    },
    "url": {
      "path": [
        "market-data",
        "event-contracts",
        "game-stats",
        "get"
      ],
      "host": [
        "{{baseUrl}}"
      ],
      "query": [
        {
          "disabled": false,
          "description": {
            "content": "(Required) Milestone ID. A milestone represents a specific game or real-world occurrence tied to events.",
            "type": "text/plain"
          },
          "key": "milestone_id",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "Category, default is US_EVENT, currently only US_EVENT is supported.",
            "type": "text/plain"
          },
          "key": "category",
          "value": ""
        }
      ],
      "variable": []
    },
    "header": [
      {
        "disabled": false,
        "description": {
          "content": "(Required) User's authenticated token.",
          "type": "text/plain"
        },
        "key": "access_token",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "The unique ID for this request. Suggest using UUID.",
          "type": "text/plain"
        },
        "key": "reqid",
        "value": ""
      },
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "method": "GET"
  }
}
```