AI & Vibe Coding - Odds-API.io

Overview

We provide AI-ready resources to help you build faster with AI coding assistants. Whether you’re using ChatGPT, Claude, Cursor, VS Code Copilot, or other AI tools, we have resources that give these tools the context they need to generate accurate, production-ready code.

Machine-Readable Documentation

We provide documentation in formats optimized for AI coding tools:

Documentation Index

A lightweight file listing all documentation pages with URLs and descriptions. AI tools can scan this to find relevant pages to fetch. URL: https://docs.odds-api.io/llms.txt Size: ~500 tokens

Complete Documentation

The entire API documentation compiled into a single text file. Best for AI tools with large context windows that can ingest everything at once. URL: https://docs.odds-api.io/llms-full.txt Size: ~2.5k tokens

OpenAPI Specification

Machine-readable API definition following the OpenAPI 3.0 standard. Contains all endpoints, parameters, request/response schemas, and examples. URL: https://docs.odds-api.io/api-reference/openapi.json Size: ~22k tokens

MCP Server

For AI tools that support the Model Context Protocol, our MCP server provides direct API access. See setup instructions below.

Quick Start: Copy-Paste Context

Copy this context block and paste it into your AI tool for instant API knowledge:

You are helping me build with the Odds-API.io sports betting odds API.

API Base URL: https://api.odds-api.io/v3
Authentication: API key as query parameter (?apiKey=YOUR_KEY)

Key endpoints:
- GET /sports - List sports (no auth)
- GET /bookmakers - List bookmakers (no auth)
- GET /events?sport={slug}&apiKey={key} - Get events
- GET /odds?eventId={id}&bookmakers={list}&apiKey={key} - Get odds
- GET /odds/multi?eventIds={ids}&bookmakers={list}&apiKey={key} - Batch odds (up to 10 events)
- GET /value-bets?bookmaker={name}&apiKey={key} - Value betting opportunities
- GET /arbitrage-bets?bookmakers={list}&apiKey={key} - Arbitrage opportunities
- GET /dropping-odds?sport={slug}&apiKey={key} - Dropping odds from sharp bookmakers (paid plans only)

For complete documentation, fetch: https://docs.odds-api.io/llms-full.txt
For OpenAPI spec: https://docs.odds-api.io/api-reference/openapi.json

Setup by Tool

Claude
ChatGPT
Cursor
VS Code
Claude Code

Claude (chat.anthropic.com)

Start a new conversation
Paste the context block above, or
Ask Claude to fetch the full documentation:

Please fetch and read https://docs.odds-api.io/llms-full.txt to understand the Odds-API.io API, then help me [your task].

ChatGPT

Start a new conversation
Paste the context block above, or
Provide the documentation URL:

Read the documentation at https://docs.odds-api.io/llms-full.txt and help me build [your project] using the Odds-API.io API.

Cursor IDE

Option 1: Project RulesCreate .cursor/rules.md in your project:

# Odds-API.io Integration

This project uses the Odds-API.io sports betting odds API.

API Base URL: https://api.odds-api.io/v3
Auth: API key as query parameter (?apiKey=YOUR_KEY)

Documentation: https://docs.odds-api.io/llms-full.txt
OpenAPI Spec: https://docs.odds-api.io/api-reference/openapi.json

Key endpoints:
- GET /sports - List sports (no auth)
- GET /bookmakers - List bookmakers (no auth)
- GET /events?sport={slug}&apiKey={key} - Get events
- GET /odds?eventId={id}&bookmakers={list}&apiKey={key} - Get odds
- GET /value-bets?bookmaker={name}&apiKey={key} - Value bets
- GET /dropping-odds?sport={slug}&apiKey={key} - Dropping odds (paid plans only)

Option 2: MCP ServerSee the MCP Server section below for direct API integration.

VS Code with GitHub Copilot

Add context to your workspace by creating a .github/copilot-instructions.md file:

# Odds-API.io Context

This project integrates with Odds-API.io for sports betting odds data.

Base URL: https://api.odds-api.io/v3
Authentication: API key as query parameter

Key endpoints:
- GET /sports - List available sports
- GET /events?sport={slug}&apiKey={key} - Get events
- GET /odds?eventId={id}&bookmakers={list}&apiKey={key} - Get odds
- GET /dropping-odds?sport={slug}&apiKey={key} - Dropping odds (paid plans only)

Full docs: https://docs.odds-api.io/llms-full.txt

Claude Code CLI

Create a CLAUDE.md file in your project root:

# Odds-API.io Project

This project uses the Odds-API.io sports betting odds API.

## API Reference

Base URL: https://api.odds-api.io/v3
Auth: API key as query parameter (?apiKey=YOUR_KEY)

Full documentation: https://docs.odds-api.io/llms-full.txt
OpenAPI spec: https://docs.odds-api.io/api-reference/openapi.json

## Key Endpoints

- GET /sports - List sports (no auth required)
- GET /bookmakers - List bookmakers (no auth required)
- GET /events?sport={slug}&apiKey={key} - Get events for a sport
- GET /odds?eventId={id}&bookmakers={list}&apiKey={key} - Get odds
- GET /value-bets?bookmaker={name}&apiKey={key} - Get value bets
- GET /arbitrage-bets?bookmakers={list}&apiKey={key} - Get arbitrage opportunities
- GET /dropping-odds?sport={slug}&apiKey={key} - Get dropping odds (paid plans only)

## Environment Variables

ODDS_API_KEY - Your API key from odds-api.io

Run claude in your project directory

MCP Server

The Model Context Protocol (MCP) server provides direct API integration for AI tools, allowing them to fetch live data from your Odds-API.io account.

Features

12 API tools - Get sports, bookmakers, events, odds, value bets, and arbitrage opportunities
Documentation resources - Access full docs and OpenAPI spec directly
Real-time data - Fetch live odds and events

Setup

Claude Code
Claude Desktop
Cursor

claude mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-server

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

Add to your Cursor MCP settings:

{
  "odds-api": {
    "command": "npx",
    "args": ["-y", "odds-api-mcp-server"],
    "env": {
      "ODDS_API_KEY": "your-api-key"
    }
  }
}

Available Tools

Tool	Description
`get_sports`	List all available sports
`get_bookmakers`	List all available bookmakers
`get_leagues`	Get leagues for a sport
`get_events`	Get events with filtering options
`get_live_events`	Get currently live events
`search_events`	Search events by text
`get_odds`	Get odds for an event
`get_multi_odds`	Get odds for multiple events
`get_value_bets`	Get value betting opportunities
`get_arbitrage_bets`	Get arbitrage opportunities
`get_participants`	Get teams/participants
`get_documentation`	Get API documentation

Example Prompts

Here are some example prompts to get you started:

Building an Odds Comparison App

Using the Odds-API.io API, help me build a React component that:
Fetches upcoming Premier League matches
Gets odds from Bet365, SingBet, and Unibet
Displays a comparison table showing the best odds for each outcome

Creating a Value Bet Finder

Help me build a Python script that:
Fetches value bets from the Odds-API.io /value-bets endpoint
Filters for bets with > 5% expected value
Sends alerts to a Discord webhook when new value bets are found

Real-Time Odds Tracker

Create a Node.js service that:
Connects to the Odds-API.io WebSocket
Tracks odds movements for specific events
Stores historical data in a database
Exposes an API endpoint for querying odds history

Resources

API Reference

Complete API documentation with all endpoints and parameters.

Quickstart Guide

Get up and running with your first API call.

Best Practices

Optimize your API usage for performance and cost.

Code Examples

Ready-to-use code examples for common use cases.

Documentation Index

​Overview

​Machine-Readable Documentation

​Documentation Index

​Complete Documentation

​OpenAPI Specification

​MCP Server

​Quick Start: Copy-Paste Context

​Setup by Tool

​Claude (chat.anthropic.com)

​ChatGPT

​Cursor IDE

​VS Code with GitHub Copilot

​Claude Code CLI

​MCP Server

​Features

​Setup

​Available Tools

​Example Prompts

​Building an Odds Comparison App

​Creating a Value Bet Finder

​Real-Time Odds Tracker

​Resources

API Reference

Quickstart Guide

Best Practices

Code Examples

Overview

Machine-Readable Documentation

Documentation Index

Complete Documentation

OpenAPI Specification

MCP Server

Quick Start: Copy-Paste Context

Setup by Tool

Claude (chat.anthropic.com)

ChatGPT

Cursor IDE

VS Code with GitHub Copilot

Claude Code CLI

MCP Server

Features

Setup

Available Tools

Example Prompts

Building an Odds Comparison App

Creating a Value Bet Finder

Real-Time Odds Tracker

Resources