> ## Documentation Index
> Fetch the complete documentation index at: https://docs.odds-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API Introduction

> Odds-API.io API reference. Access real-time betting odds from 250+ bookmakers, 100+ market types, value bets, and WebSocket feeds.

## Overview

Odds-API.io provides real-time sports betting odds data from 250+ bookmakers across 10+ sports with near-zero latency.

**Key capabilities:**

* Pre-match and live odds
* 100+ market types (ML, spreads, totals, props, etc.)
* Period scores for all periods (half-time, 90min, overtime) - enabling complete market settlement
* Direct bet links to bookmaker sites
* Automatic value bet calculation
* Historical odds data
* WebSocket real-time updates

For an up-to-date list of all supported bookmakers, visit [odds-api.io/sportsbooks](https://odds-api.io/sportsbooks).

## Quick Examples

<Tabs>
  <Tab title="Get Events">
    ```bash theme={null}
    curl "https://api.odds-api.io/v3/events?apiKey=YOUR_KEY&sport=football&limit=10"
    ```
  </Tab>

  <Tab title="Get Odds">
    ```bash theme={null}
    curl "https://api.odds-api.io/v3/odds?apiKey=YOUR_KEY&eventId=123456&bookmakers=Bet365,Unibet"
    ```
  </Tab>

  <Tab title="Find Value Bets">
    ```bash theme={null}
    curl "https://api.odds-api.io/v3/value-bets?apiKey=YOUR_KEY&bookmaker=Bet365&includeEventDetails=true"
    ```
  </Tab>
</Tabs>

## API Endpoints

The API is organized into the following endpoint categories:

<CardGroup cols={2}>
  <Card title="Sports & Leagues" icon="futbol">
    Get available sports and leagues
  </Card>

  <Card title="Events" icon="calendar">
    Fetch upcoming and live events
  </Card>

  <Card title="Bookmakers" icon="bookmark">
    Manage bookmaker selection
  </Card>

  <Card title="Odds" icon="chart-line">
    Get real-time odds data
  </Card>

  <Card title="Value Bets" icon="magnifying-glass-dollar">
    Find profitable betting opportunities
  </Card>

  <Card title="WebSocket" icon="bolt" href="/api-reference/websocket">
    Real-time odds updates via WebSocket
  </Card>
</CardGroup>

## Authentication

All API endpoints require authentication using an API key passed as a query parameter:

```
https://api.odds-api.io/v3/events?apiKey=YOUR_API_KEY&sport=football
```

<Warning>
  Never expose your API key in client-side code. Always make API calls from your backend server.
</Warning>

## Base URL

```
https://api.odds-api.io/v3
```

## Getting Help

<Card title="Contact Support" icon="envelope" href="mailto:hello@odds-api.io">
  Need help? Contact us at [hello@odds-api.io](mailto:hello@odds-api.io)
</Card>