Oddin.gg Bragi - Game-specific schemas: Dota 2

This article is section 6.2 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 · League of Legends · Valorant · eBasketball · eFootball · eCricket

6.2. Dota 2

The Dota 2 schema models a Dota 2 match as a series of maps (games). Each map has two teams (Radiant and Dire), five players per team, towers and barracks for each lane, a Roshan, and a draft phase of picks and bans before the map begins. State is kept for the match overall, for the current map, for each team, and for each player.

6.2.1. Top-level Dota 2 messages

Dota2MatchMessage

A concrete implementation of the (Game)MatchMessage pattern (see section 3.5.2.2).

Dota2MatchSnapshot

A concrete implementation of the (Game)MatchSnapshot pattern. Cache the snapshot in memory and apply later update messages to it.

Dota2MatchUpdate

Carries either a full replacement of the match state or a list of partial updates.

Dota2MatchStatePartialUpdates

6.2.2. Match-level state

Dota2MatchStatePartialUpdate

A oneof wrapper that targets a specific part of the cached match state.

Dota2MatchState

Dota2MatchScoreState

6.2.3. Picks and bans

Two representations are available for the draft phase. PicksAndBansSelectionsPerTeam is the recommended one: it splits picks and bans by team and guarantees correct ordering regardless of connection time or short data-collection gaps. PicksAndBansSelections is the older sequential representation; it is kept for backwards compatibility, but its sequence may become inconsistent if the upstream data has gaps.

PicksAndBansSelectionsPerTeam

PicksAndBansSelectionsPerTeam.HeroSelection

PicksAndBansSelectionsPerTeam.RadiantSelections / DireSelections

PicksAndBansSelections (deprecated)

PicksAndBansSelections.CurrentHeroSelection

PicksAndBansSelections.PickOrBan

6.2.4. Current map state

Dota2CurrentMapStatePartialUpdate

Oneof that targets a specific area inside the current map.

Dota2CurrentMapState

Dota2CurrentMapTimeState

Dota2PreviousMapState

6.2.5. Per-team current-map state

Dota2TeamCurrentMapStatePartialUpdate

Targets a specific team (by team URN) inside the current map.

Dota2TeamCurrentMapState

Dota2TeamCurrentMapStatisticsState

Dota2TeamPreviousMapState

6.2.6. Per-player current-map state

Dota2PlayerCurrentMapStatePartialUpdate

Targets a specific player (by player URN) inside the current map.

Dota2PlayerCurrentMapState

Dota2PlayerInfoState

Dota2PlayerCurrentMapTimersState

Dota2PlayerStatisticsState

Dota2PlayerCurrentMapStatisticsState

Dota2PlayerPreviousMapState

6.2.7. Map objects

Dota2Towers

Dota2Tower

Dota2Barracks

Dota2Barrack

Roshan

Dota2Position

Dota2Items

Dota2Item

Dota2Abilities

Dota2Ability

6.2.8. Dota 2 enums

Dota2Faction

Dota2Lane

Dota2TowerTier

Dota2BarrackType

Dota2ItemPosition

6.2.9. Dota2MatchSnapshot JSON example

{
  "match_urn": "od:match:9000",
  "sequence": 1,
  "timestamp": "2026-05-27T19:30:00.000Z",
  "data_status": "DATA_STATUS_OK",
  "announcements": [],
  "match_state": {
    "match_urn": "od:match:9000",
    "match_type": "BEST_OF_TYPE_BO3",
    "home_team": { "urn": "od:competitor:201", "name": "Team Alpha" },
    "away_team": { "urn": "od:competitor:202", "name": "Team Beta" },
    "score": { "home_score": 1, "away_score": 0 },
    "match_status": "MATCH_STATUS_TYPE_LIVE",
    "current_map": {
      "map_order": 2,
      "map_paused": false,
      "game_time": { "game_time": "1820s" },
      "day_time": true,
      "teams": {
        "od:competitor:201": {
          "team_urn": "od:competitor:201",
          "faction": "DOTA2_FACTION_RADIANT",
          "statistics": {
            "team_urn": "od:competitor:201",
            "barracks": 6,
            "kills": 14,
            "net_worth": 32500,
            "roshans": 1,
            "towers": 9,
            "has_roshans": true
          },
          "players": {}
        }
      },
      "towers": { "towers": [] },
      "barracks": { "barracks": [] },
      "roshan": {
        "alive": false,
        "respawnTime": 360,
        "position": { "x": 0.71, "y": 0.69 }
      }
    },
    "previous_maps": [],
    "picks_and_bans_selections_per_team": {
      "state": "STATE_ENDED",
      "active_team": "TEAM_TYPE_UNSPECIFIED",
      "selection_type": "SELECTION_TYPE_UNSPECIFIED",
      "active_team_time_remaining": 0,
      "radiant_bonus_time": 0,
      "dire_bonus_time": 0,
      "radiant_selections": { "bans": [], "picks": [] },
      "dire_selections": { "bans": [], "picks": [] }
    }
  },
  "tournament": { "urn": "od:tournament:2001", "name": "The International" }
}