Build on CS2 match data and odds
Everything you need to integrate the EsportsOdds API: match data with map vetoes and round stats, player stats, and a de-vigged market odds line for Counter-Strike 2 over one versioned REST API and a WebSocket channel.
quickstart.sh
curl -H "Authorization: Bearer $EO_KEY" \
"https://api.esportsodds.gg /v1/cs2/ matches?status=live"
# → { "data": [{ "id": ..., "status": "live", ... }],
# "meta": { ... } }One authenticated GET returns live matches as plain JSON. Every endpoint follows the same /v1/{game}/{resource} shape.
Start here
- QuickstartFrom an API key to live matches, odds, and a WebSocket stream in four steps.Read
- Your first integrationA complete, runnable script with pagination, retries and error handling.Read
- Sandbox keyA free key that reads a fixed sample of past matches. No card needed.Read
- What's in the dataAn honest inventory of what exists, what is thin, and what is not there at all.Read
- Budget your requestsStandard's 50,000 a month is about 69 an hour. The arithmetic, before you set a timer.Read
- Live data & WebSocketPush score and odds changes instead of polling for them.Read
- AI assistants (MCP)Ask Claude, Cursor or any MCP client about matches, teams and players.Read
- TroubleshootingThe behaviours that surprise people most often, and what to do about each.Read
Looking for worked tutorials: a Discord score bot, a live dashboard, fantasy projections? Those live on esportsodds.gg/guides.
API reference
44 endpoints in 9 groups, each with a request you can try from the page.
- Matches11 endpoints
- Teams12 endpoints
- Players8 endpoints
- Rankings3 endpoints
- Tournaments3 endpoints
- Maps2 endpoints
- Odds1 endpoint
- Live1 endpoint
- Meta3 endpoints