home / skills / openclaw / skills / odds-checker-api

odds-checker-api skill

safe

This skill retrieves and interprets Odds-API.io data to fetch event odds from selected bookmakers using a provided API key.

npx playbooks add skill openclaw/skills --skill odds-checker-api

Review the files below or copy the command above to add this skill to your agents.

Files (4)

SKILL.md

1.6 KB

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

Overview

This skill queries Odds-API.io to find sports events, bookmakers, and live betting odds using the Odds-API v3. It provides a small CLI helper to search events, list sports/bookmakers, and fetch odds by event ID. The skill requires a user-provided API key and supports previewing requests with a dry-run mode.

How this skill works

The skill calls Odds-API.io endpoints to list sports and bookmakers, perform text searches for matchups, and retrieve odds for a specific event ID and selected bookmakers. You supply the API key via an environment variable or CLI flag. A lightweight CLI script exposes commands for sports, bookmakers, search, odds, and a combined matchup flow that finds an event and fetches its odds in one step.

When to use it

You need programmatic access to Odds-API.io v3 to get current odds or bookmaker data.
You want a quick CLI to search matchups and retrieve event-specific odds.
You need to integrate odds into an app or pipeline and want to preview API requests.
You are prototyping betting tools, alerts, or comparative odds displays.
You must debug or inspect the API response structure before full integration.

Best practices

Never embed the API key in the skill; pass it via ODDS_API_KEY or --api-key at runtime.
Use --dry-run to preview request URLs and parameters before sending live requests.
Search first to obtain the canonical event ID, then fetch odds for that ID to avoid ambiguity.
Limit bookmaker lists to those you need to reduce payload size and parsing complexity.
Use --summary for compact, human-friendly output when inspecting results interactively.

Example use cases

Find odds for a specific football match by searching 'Inter vs Arsenal' then fetching odds for the returned event ID.
List available sports and bookmakers to let users pick which markets or providers to include.
Run a one-step matchup command to both search for an event and retrieve odds from selected bookmakers.
Preview API request formats with --dry-run while developing an integration or testing a new API key.
Create an automated job that queries odds for upcoming events and writes normalized results into a database.

FAQ

How do I provide my API key?

Set ODDS_API_KEY in your environment or pass --api-key on the CLI; do not hardcode keys in the skill.

Can I preview requests without an API key?

Yes. Use --dry-run to see the constructed URL and parameters without making a live API call.