esports

v2026.09.24

Esports data — Dota 2 (OpenDota) and League of Legends esports (Leaguepedia). Pro matches, tournaments, teams, and structured LoL competitive data. Use when: user asks about Dota 2 pro matches/teams/leagues, or LoL esports tournaments/rosters/results. Don't use when: user asks about esports betting/odds — use the `kalshi` (get_esports_odds) or `polymarket` (get_esports_events) skills (no keyless bookmaker-odds source exists). Don't use for non-Dota/LoL titles (only Dota 2 and LoL are covered).

GitHub
Install command
npx skhub add machina-sports/esports
Markdown
SKILL.md

Esports Data

Keyless, public sources. No API key, no signup.

  • Dota 2 → OpenDota (api.opendota.com). Real JSON. Free tier ~60 req/min.
  • League of Legends esports → Leaguepedia Cargo (lol.fandom.com). Structured rows. CC-BY-SA — attribute Leaguepedia when you reuse the data.

CRITICAL

  • Dota 2 only for match/team/league data (OpenDota). LoL uses Leaguepedia Cargo.
  • Leaguepedia is aggressively rate-limited. The throttle comes back as an in-body error (Leaguepedia API error: ...) on an HTTP 200 — not a 4xx. Results are cached ~30 min; don't hammer it.
  • No odds here. Bookmaker odds for esports are not available keyless. For implied-probability signals, use kalshi get_esports_odds --game=cs2 or polymarket get_esports_events.
  • Personal use. Third-party ToS apply (OpenDota MIT; Leaguepedia CC-BY-SA).

Quick Start

CLI:

sports-skills esports get_pro_matches --limit=10
sports-skills esports get_pro_teams --limit=10
sports-skills esports get_leagues --tier=premium
sports-skills esports get_lol_tournaments --region=Korea --limit=5
sports-skills esports lol_cargo_query --tables=Teams --fields=Name,Region --limit=5

Python:

from sports_skills import esports

esports.get_pro_matches(limit=10)
esports.get_lol_tournaments(region="Brazil")

Commands

CommandDescription
get_pro_matchesRecent Dota 2 professional matches (OpenDota)
get_leaguesDota 2 leagues/tournaments, filter by tier (OpenDota)
get_pro_teamsTop Dota 2 teams by rating (OpenDota)
get_matchDetailed Dota 2 match by id (OpenDota)
get_lol_tournamentsRecent LoL esports tournaments (Leaguepedia)
lol_cargo_queryRaw Leaguepedia Cargo query (any table/fields)

Leaguepedia Cargo reference

lol_cargo_query needs tables + fields. Common tables (fields vary — verify with a small query first): Tournaments (Name, DateStart, DateEnd, League, Region, Prizepool), MatchSchedule (Team1, Team2, Winner, DateTime_UTC, BestOf), ScoreboardGames, Players, Teams. Full schema: https://lol.fandom.com/wiki/Special:CargoTables.

Troubleshooting

  • Leaguepedia API error: You've exceeded your rate limit → you're being throttled. Wait and retry; the connector caches for ~30 min to help.
  • Empty matches/teams from OpenDota → transient; OpenDota is volunteer-run best-effort infra with no SLA. Retry.
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

skills/esports

Default branch

main

Latest commit

624c0a5

Tree SHA

68e96fd