Odds for sports events

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.

Security Scan

The skill appears to implement a straightforward Odds-API.io client, but packaging/metadata and credential declarations are inconsistent (it expects an API key at runtime but the registry metadata doesn't list or mark that credential), so review before installing.

Purpose & Capability

The code and SKILL.md implement an Odds-API.io CLI and reference the v3 endpoints described in the description — this matches the skill's stated purpose. However, the registry metadata declares no required environment variables or primary credential, while the instructions and code clearly expect an API key (ODDS_API_KEY or --api-key). That mismatch is unexpected but could be a packaging oversight.

Instruction Scope

SKILL.md and the included reference and CLI are narrowly scoped to listing sports/bookmakers, searching events, and fetching odds. The runtime instructions only direct network calls to the documented Odds-API.io base URL and do not ask to read unrelated files, system state, or transmit data to unexpected endpoints.

Install Mechanism

No install spec is present (instruction-only plus a small included script). Nothing is downloaded from arbitrary URLs and no packages are installed. This is a low-risk install mechanism.

Credentials

The SKILL.md and scripts use an API key via ODDS_API_KEY or --api-key, which is appropriate for this API. However, the skill's registry metadata lists no required env vars or primary credential; that omission is inconsistent and could mislead users about what secrets will be requested at runtime. There are no other unrelated credentials requested.

Persistence & Privilege

The skill does not request 'always: true' or elevated persistence. It is user-invocable and can be invoked autonomously by the agent per platform defaults, which is expected for a network API integration.

What to consider before installing

This skill's code looks like a simple, honest Odds-API.io client that makes only API requests to the documented base URL. However, the registry metadata does not declare the ODDS_API_KEY the SKILL.md and script require — that inconsistency should be resolved before trusting the package. Before installing: (1) confirm how the API key will be provided at runtime (environment vs. prompt) and ensure you won't accidentally store the key in the skill's files, (2) prefer passing the key via --api-key or setting ODDS_API_KEY in a secure environment, (3) review the included scripts yourself (they're short) to verify there are no hidden endpoints or telemetry, and (4) if possible ask the publisher for a homepage or source repo to improve transparency. If you can't verify these points, treat the omission of a declared required credential as a red flag and proceed cautiously.

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.

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