odds-api-io

# 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
1. Provide the API key via `ODDS_API_KEY` or `--api-key` (never store it in this skill).
2. Find sports and bookmakers if needed.
3. Search for the event to get its ID.
4. Fetch odds for the event with a bookmaker list.

```bash
# 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.