get_historical_odds
Get Historical Odds
Retrieve a historical snapshot of betting odds at a specific point in time. Snapshots are captured at 5-10 minute intervals dating back to June 2020. Includes navigation timestamps for iterating through time.
get_historical_odds
Retrieve a historical snapshot of betting odds at a specific point in time. Snapshots are captured at 5-10 minute intervals dating back to June 2020. Includes navigation timestamps for iterating through time.
get_event_odds
Retrieve odds for a single event across all available markets and bookmakers. Supports extended markets including player props (e.g. player points, passing touchdowns), alternate spreads/totals, and period-specific markets. Use the **Get Event Markets** tool first to discover which market keys are available.
get_odds
Retrieve live and upcoming betting odds for a given sport. Returns events with bookmaker odds for the specified regions and markets. Use `"upcoming"` as the sport to get odds across all in-season sports.
get_historical_events
Retrieve event listings as they appeared at a specific historical timestamp. Useful for discovering historical event IDs needed to query historical event-level odds via **Get Historical Odds**.
list_sports
Retrieve all available sports and leagues from The Odds API. Returns sport keys, group names, titles, and whether each sport is active or supports outrights/futures markets. Use the returned sport key as the **sport** parameter in other tools.
get_scores
Retrieve game scores and results for a given sport. Returns upcoming, live, and recently completed games with live scores that update approximately every 30 seconds. Event IDs match those from the odds endpoints for easy correlation.
get_event_markets
Discover which market keys each bookmaker currently offers for a specific event. Useful for finding available player props and secondary markets before requesting full odds data with the **Get Event Odds** tool.
get_participants
Retrieve a list of known participants (teams or individual players) for a given sport. Useful for building reference data and mapping team/player names.
get_events
List in-play and upcoming events for a sport without odds data. Useful for discovering event IDs before requesting odds or markets. This is a free endpoint that does not count against the usage quota.
Retrieve real-time and historical sports betting odds aggregated from 40+ bookmakers across 70+ sports and leagues. Fetch live and pre-match odds for markets including moneyline, spreads, totals, and futures. Access player props and alternate lines for individual events. Discover available sports, leagues, and market keys per bookmaker. Get live game scores and results with ~30-second update intervals. Look up historical odds snapshots (back to 2020) and iterate through timestamps. List participants (teams/players) for reference data. Filter odds by region (US, UK, AU, EU), odds format (decimal/American), specific bookmakers, event IDs, and time ranges.
Common questions about connecting the Odds API to AI agents with Metorial.