SportAPI
API integration

Esports Odds API: CS2, Dota 2 and LoL — Maps, Live Odds and Markets for Esports Betting

How an esports odds API structures a best-of series: maps as sub-events, the series and map scores in live, the markets you get for CS2, Dota 2 and LoL, and the requests that return them.

An API hub connected to CS2, Dota 2 and LoL panels with a live match, a list of markets, maps and a live data chart

An esports match is a series, not a single game. A CS2 best-of-three or a Dota 2 best-of-five has a series score, a score on each map, and markets on both levels. An esports odds API has to return all of that in a structure you can render: the match with its main odds, each map as its own sub-event with its own markets, and in live the series score next to the current map’s score.

On 9 November 2026 the SportAPI esports line had 85 prematch matches in 27 tournaments: 15 in CS2, 5 in Dota 2, 2 in League of Legends, plus Rainbow Six, Honor of Kings, WarCraft III and mobile shooters. Another 18 matches were live. Below is how the data is organized, which markets come with it and the three requests that return everything. The feed is the SportAPI esports line, from $30 a month, with a free two-day test key.

What esports betting needs from a feed

  • The series and the maps separately. “Team A to win the match” and “Team A to win map 2” are different bets with different prices.
  • A score at two levels in live. Maps won in the series, and rounds or kills on the map being played.
  • Markets that follow the format. Total maps, map handicap and correct score make sense in a best-of-three and change shape in a best-of-five.
  • Fast reaction between maps. When a map ends, its markets close and the next map’s markets become the live ones.
  • One format across games. CS2, Dota 2 and LoL should come in the same structure, so one front end serves all of them.

What’s in the esports line

GamePrematch tournaments on 9 November 2026Examples
CS215BLAST Rivals, a PGL Major, ESL Challenger League, CCT series, regional leagues
Dota 25DreamLeague divisions and other series
League of Legends2World Championship
Other titles5Rainbow Six, Honor of Kings, WarCraft III, CrossFire Mobile, Standoff 2

The list follows the tournament calendar: the API shows only what currently has scheduled matches. Fighting games and sports simulators come in the same esports menu as separate sections.

How a match is structured

Esports data is requested with the cybersport=true parameter. A match object looks like any match in the feed, with two esports-specific readings of the score fields.

In live, on the same day, a CS2 match in its third map and a Dota 2 match in its second looked like this:

FieldCS2 exampleDota 2 exampleMeaning
score_full"1:1""1:0"Maps won in the series
score_period"19:16;7:13;1:5""32:8;8:31"The score of each map, the current one last
period_name"3rd map""2nd map"The map being played
game_desk"map""map"The type of period
timer01838Game clock in seconds, where the game has one

On each map the score is rounds in CS2 and kills in Dota 2. A formatter for both:

// score_full: maps won; score_period: the score of every map, the current one last
function esportsScore(match) {
  const maps = (match.score_period || '')
    .split(';')
    .filter(Boolean)
    .map((m) => m.split(':').map(Number)); // [[19, 16], [7, 13], [1, 5]]
  return { series: match.score_full, playing: match.period_name, maps };
}

The detailed match object also carries sub_games. For a League of Legends World Championship match that day the list was:

1st map · 2nd map · 3rd map · 4th map · 5th map
Special bets,1st map … Special bets,5th map
Players' stats,1st map

Each sub-event has its own game_id. Request it with the same event method and you get the markets of that map only.

Markets on the match and on the map

For the same match the main object returned seven markets and 26 selections:

MarketWhat it is
Match winnerTwo-way: there’s no draw in a series
Correct scoreThe series score, such as 3:1
Total mapsOver or under a number of maps played
Total maps handicapA map handicap for one of the teams
Total fragsOver or under the total number of kills
Team to win at least one mapFor each team

Map-level markets, the winner of the map and its totals, live in the map’s sub-event, and the “special bets” and “players’ stats” sub-events hold the game-specific and player markets when they’re offered. Read the markets the API returns instead of hard-coding a list: the set differs by game, by tournament and by the time left before the start.

Three requests that return everything

GET https://YOUR_API_DOMAIN/v1/menu/live/en?cybersport=true
GET https://YOUR_API_DOMAIN/v1/events/{sportId}/0/sub/50/live/en?cybersport=true
GET https://YOUR_API_DOMAIN/v1/event/{gameId}/group/live/en?cybersport=true

Each request carries the Package: YOUR_API_KEY header. The API domain and the key are issued by the SportAPI manager. The first request returns the esports menu with the current sections and tournaments; take {sportId} from it. The second returns the matches with scores and the main odds; replace live with line for upcoming matches. The third returns one match with every market and its sub_games, which are described in the sub-events documentation.

Map markets come from the same third request with a map’s game_id:

// maps are sub-events named "1st map", "2nd map", ...
// fetchLine is your server-side helper: it adds the Package header and caches the response
const mapSubs = match.sub_games.filter((s) => /^\d(st|nd|rd|th) map$/.test(s.game_name));
for (const s of mapSubs) {
  const map = await fetchLine(`/v1/event/${s.game_id}/group/live/en?cybersport=true`, 5_000);
  // map.game_oc_list: the markets of this map only
}

Live: what changes and how often to ask

Poll the live list no more often than every 7 seconds and an open match every 5. Between polls three things change: the score of the current map in score_period, the odds and their oc_block flags, and, when a map ends, score_full, period_name and the markets that are open. Rebuild the markets from each response; a selection that left the response must leave the page.

The matches we looked at also had va: 1, which means a video stream is available for the match through the separate video service. For an esports page that’s often the first thing users ask for.

From odds to accepted bets

If you accept bets, the selection’s pointer from the line goes to the Coupon API, which re-checks the price at placement and settles the bet after the map or the series ends. How settlement works, including refunds when a match is cancelled, is in the article on automated bet settlement. For a community product without bets, the same data feeds a schedule and score bot; an example is in Esports Discord Bot.

What the feed doesn’t have

  • Player history and team statistics. The feed is about matches, scores and odds, not about career stats.
  • WebSocket. Updates are pulled over REST; WebSocket is in development.
  • A fixed list of games. A title is in the menu when it has scheduled matches.

What it costs

What you needCost
The esports line: prematch and live, markets and oddsfrom $30 a month
Bet acceptance and automatic settlementfrom $300 a month
Testing before you payfree two-day test key

FAQ

Which games does the esports odds API cover?

On the day of the snapshot: CS2, Dota 2, League of Legends, Rainbow Six, Honor of Kings, WarCraft III and mobile shooters, plus fighting games and sports simulators in separate sections. The list follows the tournament calendar.

How do I get odds for a single map?

Each map is a sub-event of the match with its own game_id. Take it from sub_games and request it with the event method.

How is the live score returned?

score_full is the series score in maps, and score_period lists the score of each map, with the map in play last. period_name names that map.

Is there a draw in esports markets?

Not in a series: the match winner market has two selections. Individual formats can differ, so read the selections the API returns.

Can I test it before paying?

Yes. The test key works for two days and includes the esports line with prematch and live.

What to check on a live series

Open a live CS2 or Dota 2 match on a test key and watch one map end: score_full changes, period_name moves to the next map and the finished map’s markets close. If your page follows that without a reload, the hard part of an esports front end is done. Ask the SportAPI manager on Telegram for the API domain and a test key.

← All articles