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.