Skill: diegopetrucci/odds-checker-api (version 1.0.0)

--- name: odds-api-io description: Query Odds-API.io for sports events, bookmakers, and betting odds (e.g., "what are the odds for Inter vs Arsenal", "get odds for Paddy the Baddie vs Gaethje"). Use when you need to call the Odds-API.io v3 API or interpret its responses; requires a user-provided API key. --- # 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.

path: references/odds-api-reference.md
content: # Odds-API.io quick reference (v3)

## Base URL
- https://api.odds-api.io/v3

## Authentication
- Pass the API key as a query parameter: `[REDACTED_SECRET]`.
- Never store the key in this skill or repo. Prefer `ODDS_API_KEY`.

## Core endpoints (GET)
- `/sports` - List sports (no apiKey required).
- `/bookmakers` - List bookmakers (no apiKey required).
- `/events` - List events for a sport.
  - Required: `sport` (slug)
  - Optional: `league`, `participantId`, `status`, `from`, `to`, `bookmaker`
- `/events/search` - Search events by name.
  - Required: `query` (min 3 chars)
- `/events/{id}` - Get a single event by ID.
- `/odds` - Fetch odds for a specific event.
  - Required: `eventId`, `bookmakers` (comma-separated, max 30)
- `/odds/multi` - Fetch odds for multiple events.
  - Required: `eventIds` (comma-separated, up to 10), `bookmakers`
- `/odds/movements` - Odds movement for an event/market/bookmaker.
  - Required: `eventId`, `bookmaker`, `market`
- `/value-bets` - Value bet opportunities.
- `/arbitrage-bets` - Arbitrage opportunities.

## Response fields (selected)
### `SimpleEventDto` (from `/events`, `/events/search`)
- `id` (integer)
- `date` (string)
- `home`, `away` (string)
- `sport` { `name`, `slug` }
- `league` { `name`, `slug` }
- `status` (string)

### Odds response (from `/odds`)
- `id`, `date`, `home`, `away`, `status`
- `sport` { `name`, `slug` }
- `league` { `name`, `slug` }
- `bookmakers` map: `{ "BookmakerName": [markets...] }`
- `urls` map: `{ "BookmakerName": "link" }`

## Recommended workflow
1. `/sports` to get sport slugs.
2. `/events/search` to find candidate events and IDs.
3. `/bookmakers` to pick bookmaker names.
4. `/odds` with `eventId` and `bookmakers`.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)