Oddin.gg Bragi - Game-specific schemas: eBasketball
This article is section 6.5 of Oddin.gg Bragi - Data Feed documentation. Sections 1 to 5 there cover general information, the match timeline, processing the data feed, match events and team profiles.
Other game schemas: Counter-Strike 2 · Dota 2 · League of Legends · Valorant · eFootball · eCricket
6.5. eBasketball (Rush Basketball)
The Rush Basketball schema models a single eBasketball game between two teams (light and dark), played across four 12-minute quarters with possible overtime periods. Unlike the team-based Esports, each "team" has a single player. State is kept for the match overall, for the current map, for each team and includes a timeline of significant events.
6.5.1. Top-level eBasketball messages
RushBasketballMatchMessage
| Field | Type | Description |
match_urn |
string |
Match identifier. |
sequence |
uint64 |
Sequence number; must be exactly cached sequence + 1. |
timestamp |
google.protobuf.Timestamp |
Time the message was produced. |
data_status |
DataStatus |
Quality flag for the underlying data. |
payload |
RushBasketballMatchMessage.Payload |
Oneof: snapshot (RushBasketballMatchSnapshot) or update (RushBasketballMatchUpdate). |
RushBasketballMatchSnapshot
| Field | Type | Description |
match_urn |
string |
Match identifier. |
sequence |
uint64 |
Initial sequence number. |
timestamp |
google.protobuf.Timestamp |
Snapshot timestamp. |
data_status |
DataStatus |
Quality flag for the underlying data. |
announcements |
repeated Announcement |
Operational announcements for the match. |
match_state |
RushBasketballMatchState |
Full current state of the match. |
tournament |
Tournament |
Tournament the match belongs to. |
RushBasketballMatchUpdate
| Field | Type | Description |
payload |
RushBasketballMatchUpdate.Payload |
Oneof: match_state (full state) or partial_updates. |
RushBasketballMatchStatePartialUpdates
| Field | Type | Description |
updates |
repeated RushBasketballMatchStatePartialUpdate |
Non-empty list of partial updates to apply. |
6.5.2. Match-level state
6.5.2. Match-level stateRushBasketballMatchStatePartialUpdate
| Field | Type | Description |
current_map_state |
RushBasketballCurrentMapState |
Replaces the current_map property. Sent periodically as a safety idempotent update. |
current_map_state_partial_update |
RushBasketballCurrentMapStatePartialUpdate |
Applies a partial update inside the current map. |
timeline |
RushBasketballTimelineState |
Replaces the timeline property in RushBasketballMatchState. |
RushBasketballMatchState
| Field | Type | Description |
match_urn |
string |
Match identifier. |
match_type |
BestOfType |
Match format. |
home_team |
Team |
Home team. |
away_team |
Team |
Away team. |
match_status |
MatchStatusType |
Lifecycle status of the match. |
timeline |
RushBasketballTimelineState |
Ordered list of significant events from the game. |
current_map |
RushBasketballCurrentMapState |
State of the game currently being played. |
RushBasketballTimelineState
| Field | Type | Description |
events |
repeated RushBasketballTimelineEvent |
Ordered list of timeline events. |
RushBasketballTimelineEvent
| Field | Type | Description |
team_urn |
string |
URN of the team the event applies to. |
event_type |
RushBasketballEventType |
Type of event (three pointer, foul, period change, etc.). |
remaining_time |
google.protobuf.Duration |
Game time remaining when the event happened. |
period |
RushBasketballPeriod |
Period the event happened in. |
6.5.3. Current map state
RushBasketballCurrentMapStatePartialUpdate
| Field | Type | Description |
game_time |
RushBasketballCurrentMapTimeState |
Replaces the game_time property. |
score |
RushBasketballCurrentMapScoreState |
Replaces the score property. |
team_current_map_state |
RushBasketballTeamCurrentMapState |
Replaces a team's entry inside the teams map (keyed by team URN). |
team_current_map_partial_update |
RushBasketballTeamCurrentMapStatePartialUpdate |
Applies a partial update inside a team's current-map state. |
ball_possession |
RushBasketballBallPossession |
Replaces the ball_possession property. |
RushBasketballCurrentMapState
| Field | Type | Description |
period |
RushBasketballPeriod |
Current period (quarter or overtime number). |
game_time |
RushBasketballCurrentMapTimeState |
Time remaining in the period. |
score |
RushBasketballCurrentMapScoreState |
Score on the current map. |
map_paused |
bool |
true if the game is paused. |
teams |
map<string, RushBasketballTeamCurrentMapState> |
Per-team state, keyed by team URN. |
ball_possession |
RushBasketballBallPossession |
Which side currently has the ball. |
RushBasketballCurrentMapTimeState
| Field | Type | Description |
remaining_time |
google.protobuf.Duration |
Time left in the current period. |
RushBasketballCurrentMapScoreState
| Field | Type | Description |
home_score |
uint32 |
Points scored by the home team so far. |
away_score |
uint32 |
Points scored by the away team so far. |
6.5.4. Per-team current-map state
RushBasketballTeamCurrentMapStatePartialUpdate
| Field | Type | Description |
team_urn |
string |
Team identifier the update applies to. |
payload |
RushBasketballTeamCurrentMapStatePartialUpdate.Payload |
Oneof: map_statistics or player. |
RushBasketballTeamCurrentMapState
| Field | Type | Description |
team_urn |
string |
Team identifier. |
map_statistics |
RushBasketballTeamCurrentMapStatisticsState |
Team-level statistics for the current map. |
player |
RushBasketballPlayerCurrentMapState |
The single player representing this team. |
RushBasketballPlayerCurrentMapState
| Field | Type | Description |
player_urn |
string |
Player identifier. |
ext_name |
string |
External display name from the data source. |
RushBasketballTeamCurrentMapStatisticsState
| Field | Type | Description |
points_total |
uint32 |
Total points scored so far. |
points_ht |
uint32 |
Points scored in the first half (quarters 1 and 2). |
period_points |
repeated RushBasketballPeriodPoints |
Points scored in each period so far. |
three_pointers |
uint32 |
Number of three pointers made. |
two_pointers |
uint32 |
Number of two pointers made. |
free_throws_successful |
uint32 |
Successful free throws. |
free_throws_missed |
uint32 |
Missed free throws. |
fouls |
uint32 |
Fouls committed. |
RushBasketballPeriodPoints
| Field | Type | Description |
period |
RushBasketballPeriod |
Period the points were scored in. |
points |
uint32 |
Points scored in that period. |
6.5.5. eBasketball enums
RushBasketballBallPossession
| Value | Description |
| RUSH_BASKETBALL_BALL_POSSESSION_UNSPECIFIED | Default; possession is not known. |
| RUSH_BASKETBALL_BALL_POSSESSION_LIGHT | Light side has the ball. |
| RUSH_BASKETBALL_BALL_POSSESSION_DARK | Dark side has the ball. |
RushBasketballEventType
| Value | Description |
| RUSH_BASKETBALL_EVENT_TYPE_UNSPECIFIED | Default; event type is not known. |
| RUSH_BASKETBALL_EVENT_TYPE_THREE_POINTER | Three pointer scored. |
| RUSH_BASKETBALL_EVENT_TYPE_TWO_POINTER | Two pointer scored. |
| RUSH_BASKETBALL_EVENT_TYPE_FREE_THROW_SUCCESS | Successful free throw. |
| RUSH_BASKETBALL_EVENT_TYPE_FREE_THROW_MISS | Missed free throw. |
| RUSH_BASKETBALL_EVENT_TYPE_FOUL | Foul committed. |
| RUSH_BASKETBALL_EVENT_TYPE_PERIOD_CHANGE | A new period has started. |
RushBasketballPeriod
| Value | Description |
| RUSH_BASKETBALL_PERIOD_UNSPECIFIED | Default; period is not known. |
| RUSH_BASKETBALL_PERIOD_QUARTER_1 | Quarter 1. |
| RUSH_BASKETBALL_PERIOD_QUARTER_2 | Quarter 2. |
| RUSH_BASKETBALL_PERIOD_QUARTER_3 | Quarter 3. |
| RUSH_BASKETBALL_PERIOD_QUARTER_4 | Quarter 4. |
| RUSH_BASKETBALL_PERIOD_OVERTIME | Deprecated. Generic overtime; use one of the numbered overtimes. |
| RUSH_BASKETBALL_PERIOD_OVERTIME_1 ... OVERTIME_10 | Numbered overtime periods (1 to 10). |