> ## Documentation Index
> Fetch the complete documentation index at: https://oddsstream.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Real-time sports betting odds API with data from 10+ European bookmakers.

# Welcome to OddsStream API

OddsStream scrapes and normalizes odds from **10+ European bookmakers** every 5–30 seconds, then serves them via a clean REST API and WebSocket stream — with Pinnacle as the sharp reference line for EV detection.

## How it works

<Steps>
  <Step title="Scrapers collect odds">
    Our scrapers run continuously against Winamax, Betclic, Unibet, Betsson, Pinnacle, and more — pulling odds for every market across Football, Basketball, Tennis, Hockey, and Baseball.
  </Step>

  <Step title="Odds are normalized">
    Raw bookmaker data is standardized into a unified schema: competition codes, market types, decimal odds — fully comparable across all bookmakers.
  </Step>

  <Step title="You access them via API">
    Query via REST (`GET /api/odds`) or subscribe to real-time changes via WebSocket. Value bets are pre-calculated against Pinnacle's devigged line on our side — no math required on yours.
  </Step>
</Steps>

## What you can build

<CardGroup cols={2}>
  <Card title="Odds comparison tools" icon="scale-balanced">
    Display best available odds across all bookmakers for any match and market type.
  </Card>

  <Card title="Value bet finders" icon="chart-line">
    Surface +EV opportunities automatically via `/api/value-bets` — Pinnacle devigged, pre-filtered.
  </Card>

  <Card title="Live betting apps" icon="bolt">
    Stream odds changes in real time over WebSocket. Typically 1–3 seconds from scrape to your app.
  </Card>

  <Card title="Betting analytics" icon="chart-bar">
    Build EV history tracking, market depth analysis, and CLV measurement tools.
  </Card>
</CardGroup>

## Coverage

| Sport      | Bookmakers | Market types                                                                 |
| ---------- | ---------- | ---------------------------------------------------------------------------- |
| Football   | 8+         | 1X2, Asian Handicap, Over/Under, BTTS, Double Chance, DNB, European Handicap |
| Basketball | 5+         | Moneyline, Spread, Totals, Player Props                                      |
| Tennis     | 5+         | Moneyline, Game Handicap, Total Games                                        |
| Hockey     | 4+         | Moneyline, Puck Line, Totals                                                 |
| Baseball   | 3+         | Moneyline, Run Line, Totals                                                  |

## Base URL

```
https://api.oddsstream.io
```

## Plans

| Plan          | Rate limit   | WebSocket          | What's included                                |
| ------------- | ------------ | ------------------ | ---------------------------------------------- |
| **Free**      | 200 req/day  | 30 connections/day | Sports, Bookmakers, Events, Odds (1 bookmaker) |
| **Pro**       | 5,500 req/hr | Not included       | Everything above + Value Bets, all bookmakers  |
| **Pro+ RT**   | 5,500 req/hr | Unlimited          | Everything above + WebSocket stream            |
| **Pro+ Live** | 5,500 req/hr | Unlimited          | Everything above + Live in-play odds           |

<CardGroup cols={2}>
  <Card title="Get started free" icon="rocket" href="/quickstart">
    Your first API call in under 2 minutes.
  </Card>

  <Card title="WebSocket guide" icon="plug" href="/guides/websocket-setup">
    Build a real-time live odds feed.
  </Card>
</CardGroup>