AgentSkillsCN

odds-api-io

通过Odds-API.io查询体育赛事、博彩公司和投注赔率（例如，“国际米兰对阵阿森纳的赔率是多少”，“获取帕迪·坏小子对阵盖斯杰的赔率”）。适用于需要调用Odds-API.io v3 API或解释其响应的情况；需要用户提供API密钥。

SKILL.md
--- frontmatter
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.