Odds-API.io

Overview

Use Odds-API.io to search events and fetch odds by event ID. This skill includes a small CLI helper and a concise endpoint reference.

Quick workflow

Provide the API key via ODDS_API_KEY or --api-key (never store it in this skill).

Find sports and bookmakers if needed.

Search for the event to get its ID.

Fetch odds for the event with a bookmaker list.

# 1) List sports and bookmakers
python3 odds-api-io/scripts/odds_api.py sports
python3 odds-api-io/scripts/odds_api.py bookmakers

# 2) Search for an event
python3 odds-api-io/scripts/odds_api.py search --query "Inter vs Arsenal" --sport football

# 3) Fetch odds for the chosen event ID
python3 odds-api-io/scripts/odds_api.py odds --event-id 123456 --bookmakers "Bet365,Unibet"

# Optional: one-step search + odds
python3 odds-api-io/scripts/odds_api.py matchup --query "Inter vs Arsenal" --sport football --bookmakers "Bet365,Unibet"

CLI helper

Use scripts/odds_api.py for API calls. Pass global flags like --api-key and --dry-run before the subcommand. Prefer --dry-run to preview the URL when testing without a key. Use --summary on odds or matchup for a compact output.

Reference material

Load references/odds-api-reference.md for base URL, endpoint summaries, and response fields.