# SportsGameOdds API Documentation

> Real-time and historical sports betting odds data API. Get live odds, player props, spreads, totals, and moneylines from major sportsbooks.

## Docs

- [Data Explorer - Browse API Data Schema](https://sportsgameodds.com/docs/explorer.mdx): Interactive tool to browse SportsGameOdds API data. Explore sports, leagues, teams, events, and odds markets to get a better understanding of the data schema without writing code.
- [FAQ - Common Questions and Troubleshooting](https://sportsgameodds.com/docs/faq.mdx): Answers to common SportsGameOdds API questions. Authentication, filtering, rate limits, error handling, oddID format, player props, historical data, and optimization tips.
- [Support - Get Help with the API](https://sportsgameodds.com/docs/help.mdx): Contact SportsGameOdds support via email, live chat, or Discord. Learn about how we prioritize issues and what to include when reporting an issue.
- [SportsGameOdds API - Sports Betting Odds Data for Developers](https://sportsgameodds.com/docs.mdx): Real-time sports betting odds API with 80+ bookmakers, 55+ leagues. Get moneylines, spreads, player props, and live scores. Free tier available.
- [API Reference - Endpoints and Parameters](https://sportsgameodds.com/docs/reference.mdx): Complete SportsGameOdds API reference with interactive testing. All endpoints, query parameters, request/response schemas.
- [SDK Guide - TypeScript, Python, Ruby, Go, Java](https://sportsgameodds.com/docs/sdk.mdx): Official SportsGameOdds SDKs with auto-pagination, type safety, and error handling. Install guides and code examples for all supported languages.
- [API Cheat Sheet - Quick Reference](https://sportsgameodds.com/docs/basics/cheat-sheet.mdx): SportsGameOdds API cheat sheet with endpoints, authentication, oddID format, and response structure. Copy-paste examples for common requests.
- [Introduction - SportsGameOdds API](https://sportsgameodds.com/docs/basics.mdx): Sports betting odds API with 80+ bookmakers, 55+ leagues. Pay per event, not per market. Get real-time odds, scores, and player props in one request.
- [Quickstart - First API Call in 5 Minutes](https://sportsgameodds.com/docs/basics/quickstart.mdx): Make your first SportsGameOdds API call with copy-paste code examples. Fetch live NFL, NBA, and MLB odds in JavaScript, Python, Ruby, PHP, or Java.
- [Setup Guide - API Keys and Authentication](https://sportsgameodds.com/docs/basics/setup.mdx): Get your SportsGameOdds API key and authenticate requests. Use x-api-key header or apiKey query param. Includes SDK install and code examples.
- [Bet Type and Side Data Types - betTypeID and sideID](https://sportsgameodds.com/docs/data-types/bet-types.mdx): All betTypeID and sideID values in the SportsGameOdds API. Moneyline (ml), spread (sp), over/under (ou), 3-way, and prop bet definitions.
- [Bookmaker Data Type - bookmakerID](https://sportsgameodds.com/docs/data-types/bookmakers.mdx): Complete list of bookmakerID values. DraftKings, FanDuel, BetMGM, Caesars, PrizePicks, Pinnacle, and 80+ more sportsbooks and DFS platforms.
- [Data Types Overview - API Schema Reference](https://sportsgameodds.com/docs/data-types.mdx): How SportsGameOdds API data types relate. Hierarchy of sports, leagues, teams, events, odds, and bookmakers with identifier formats explained.
- [League Data Type - leagueID](https://sportsgameodds.com/docs/data-types/leagues.mdx): Complete list of leagueID values. NFL, NBA, MLB, NHL, EPL, La Liga, Champions League, NCAA, UFC, and 55+ leagues across all major sports.
- [Supported Markets - Odds Coverage by League](https://sportsgameodds.com/docs/data-types/markets.mdx): Interactive market browser showing oddID coverage by league and bookmaker. Filter by sport, bet type, market type, or sportsbook to see available markets.
- [Odds Data Type - oddID](https://sportsgameodds.com/docs/data-types/odds.mdx): How oddID works in the SportsGameOdds API. Format is statID-statEntityID-periodID-betTypeID-sideID. Includes examples and field reference.
- [Period Data Type - periodID](https://sportsgameodds.com/docs/data-types/periods.mdx): All periodID values for game segments. Full game, halves (1h, 2h), quarters (1q-4q), innings, periods, sets, rounds by sport.
- [Sports Data Type - sportID](https://sportsgameodds.com/docs/data-types/sports.mdx): Complete list of sportID values. Basketball, football, baseball, hockey, soccer, tennis, golf, MMA, and more supported sports.
- [Stat Entity Data Type - statEntityID](https://sportsgameodds.com/docs/data-types/stat-entity.mdx): How statEntityID works. Values include home, away, all (combined), playerID for props, or teamID for tournaments. Used in odds and results.
- [Stat Data Type - statID](https://sportsgameodds.com/docs/data-types/stats.mdx): All statID values organized by sport. Points, rebounds, assists, touchdowns, passing yards, goals, and player props for every supported sport.
- [GET /events - Fetch Games, Odds, and Results](https://sportsgameodds.com/docs/endpoints/getEvents.mdx): Retrieve sports events with live odds, scores, player props, and results. Filter by league, team, date, or odds market. Includes all bookmaker lines.
- [GET /leagues - List All Leagues](https://sportsgameodds.com/docs/endpoints/getLeagues.mdx): Retrieve all supported leagues with leagueID values. Filter by sportID. Returns NFL, NBA, MLB, NHL, EPL, and 50+ other leagues.
- [GET /markets - Fetch Market Metadata](https://sportsgameodds.com/docs/endpoints/getMarkets.mdx): Retrieve metadata about markets. Keyed by oddID. Includes information on supported leagues/bookmakers, display names, identifiers, classification (main markets, props, type of prop, etc.)
- [GET /players - Fetch Player Data](https://sportsgameodds.com/docs/endpoints/getPlayers.mdx): Retrieve player information including names, team, position, and identifiers. Filter by playerID, teamID, or leagueID. Supports pagination.
- [GET /sports - List All Sports](https://sportsgameodds.com/docs/endpoints/getSports.mdx): Retrieve all supported sports with their sportID values. Returns basketball, football, baseball, hockey, soccer, tennis, golf, MMA, and more.
- [GET /stats - List All Stats](https://sportsgameodds.com/docs/endpoints/getStats.mdx): Retrieve all supported statistics with statID values. Filter by sportID. Returns points, rebounds, assists, touchdowns, and sport-specific stats.
- [GET /teams - Fetch Team Data](https://sportsgameodds.com/docs/endpoints/getTeams.mdx): Retrieve team information including names, colors, and identifiers. Filter by teamID, leagueID, or sportID. Supports pagination.
- [GET /account/usage - Check API Usage and Limits](https://sportsgameodds.com/docs/endpoints/getUsageData.mdx): Check your API key rate limits and current usage. Returns requests per minute, objects per month, and remaining quota by time interval.
- [Stream Events](https://sportsgameodds.com/docs/endpoints/streamEvents.mdx)
- [Arbitrage Calculator Example - Python](https://sportsgameodds.com/docs/examples/arbitrage-calculator.mdx): Build an arbitrage finder with the SportsGameOdds API. Scan bookmakers for odds discrepancies, calculate guaranteed profit. Full Python code.
- [Live Odds Tracker Example - JavaScript](https://sportsgameodds.com/docs/examples/live-odds-tracker.mdx): Build a live odds tracker with the SportsGameOdds API. Detect line movement and price changes across bookmakers every 30 seconds. Full Node.js code.
- [Odds Comparison Dashboard Example - React/Next.js](https://sportsgameodds.com/docs/examples/odds-comparison-dashboard.mdx): Build an odds comparison dashboard with the SportsGameOdds API. Compare lines across bookmakers in real-time. Full Next.js TypeScript code with Tailwind.
- [Parlay Calculator Example - JavaScript](https://sportsgameodds.com/docs/examples/parlay-builder.mdx): Build a parlay calculator with the SportsGameOdds API. Calculate combined odds, payouts, and implied probability. Full Node.js code with round robin support.
- [Player Props Analyzer Example - Python](https://sportsgameodds.com/docs/examples/player-props-analyzer.mdx): Build a player props analyzer with the SportsGameOdds API. Compare bookmaker lines, find outliers, and identify value bets. Full Python code.
- [Pagination Guide - Cursor-Based Batching](https://sportsgameodds.com/docs/guides/data-batches.mdx): Fetch large datasets with cursor pagination. Use nextCursor and limit parameters to iterate through events, teams, and players efficiently.
- [Teams Guide - Fetch by ID, League, or Sport](https://sportsgameodds.com/docs/guides/fetching-teams.mdx): Query /teams endpoint by teamID, leagueID, or sportID. Get team names, colors, and identifiers with code examples in multiple languages.
- [Handling Odds - Parse Results and Grade Bets](https://sportsgameodds.com/docs/guides/handling-odds.mdx): Access odds data from events, grade over/under and spread bets using closeOverUnder and score fields. JavaScript example for processing results.
- [Real-Time Streaming API (WebSocket)](https://sportsgameodds.com/docs/guides/realtime-streaming-api.mdx): WebSocket streaming for live odds updates via Pusher. Connect to events:live, events:upcoming, or events:byid feeds. AllStar plan required.
- [Optimize Response Speed and Latency](https://sportsgameodds.com/docs/guides/response-speed.mdx): Reduce API response times with oddIDs filtering. Fetch only needed markets using PLAYER_ID wildcard and includeOpposingOddIDs parameter.
- [AI-Assisted Development - MCP Server and Context](https://sportsgameodds.com/docs/info/ai-vibe-coding.mdx): Use Claude Code, Cursor, or Copilot with SportsGameOdds API. Install MCP server, access llms.txt docs, and copy-paste AI context for accurate code generation.
- [Best Practices and Common Mistakes](https://sportsgameodds.com/docs/info/best-practices.mdx): API best practices for security, performance, and cost optimization. Avoid common mistakes like frontend API calls, over-polling, and missing filters.
- [Consensus Odds - Fair and Book Calculations](https://sportsgameodds.com/docs/info/consensus-odds.mdx): How fairOdds and bookOdds are calculated. Linear regression finds fair lines, median odds across bookmakers, juice removal for true probability.
- [Error Codes and Troubleshooting](https://sportsgameodds.com/docs/info/errors.mdx): Full reference of all error codes, what they mean and how to troubleshoot them. Includes code examples with best practices for error handling.
- [Sports Betting Glossary - Terms and Definitions](https://sportsgameodds.com/docs/info/glossary.mdx): Betting terminology explained with API field mappings. Moneyline, spread, over/under, juice, arbitrage, closing line value, and more.
- [Rate Limits by Plan - Requests and Objects](https://sportsgameodds.com/docs/info/rate-limiting.mdx): Rate limits for Amateur, Rookie, Pro, and AllStar plans. Check usage via /account/usage endpoint. Strategies to avoid 429 errors and optimize requests.
- [Migration Guide - V1 to V2 API](https://sportsgameodds.com/docs/info/v1-to-v2.mdx): Upgrade from API v1 to v2. Combined /events endpoint, new playerID format, deeplinks, altLines parameter, and field name changes explained.
- [Need Help](https://sportsgameodds.com/docs/snippets/need-help.mdx)