Over15AIOver15AI
/
Documentation

Odds API

Starter+

Real-time betting odds for football matches with multiple markets

Overview

The Odds API provides real-time betting odds for football matches worldwide. Access market odds for 1X2 (match result), Over/Under goals, Both Teams To Score (BTTS), Double Chance, Asian Handicap, Correct Score, and more.

Base URL:https://api.over15ai.com/v1
Authentication:Required
Tier Required:
Starter+

Endpoints

GET
/odds/:matchId

Get complete betting odds for a specific match

Path Parameters

matchId
required
- Match identifier from Fixtures API

Query Parameters

format
optional

Odds format: decimal, american, fractional (default: decimal)

markets
optional

Comma-separated market types (e.g., 1x2,over_under,btts)

curl https://api.over15ai.com/v1/odds/760486 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": {
    "match": {
      "id": "760486",
      "homeTeam": "Netherlands",
      "awayTeam": "Romania",
      "league": "FIFA World Cup",
      "startTime": "2026-07-02T19:00:00Z"
    },
    "markets": {
      "matchResult": {
        "home": { "odds": 1.50, "probability": 66.7 },
        "draw": { "odds": 4.20, "probability": 23.8 },
        "away": { "odds": 6.50, "probability": 15.4 }
      },
      "overUnder": {
        "lines": [
          {
            "line": 1.5,
            "over": { "odds": 1.19 },
            "under": { "odds": 4.20 }
          },
          {
            "line": 2.5,
            "over": { "odds": 1.73 },
            "under": { "odds": 2.10 }
          }
        ]
      },
      "bothTeamsToScore": {
        "yes": { "odds": 1.85 },
        "no": { "odds": 1.95 }
      }
    }
  }
}

GET
/odds/today

Get odds for all today's matches

Query Parameters

league
optional

Filter by league slug (e.g., eng.1 for Premier League)

market
optional

Filter by market type

limit
optional

Results per page (1-100, default: 50)

curl "https://api.over15ai.com/v1/odds/today?league=eng.1&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Available Markets

All betting markets provided by the Odds API

Match Result

  • • 1X2 (Home/Draw/Away)
  • • Double Chance
  • • Draw No Bet

Goals

  • • Over/Under 1.5, 2.5, 3.5
  • • Both Teams To Score
  • • Correct Score

Advanced

  • • Asian Handicap
  • • European Handicap
  • • Half Time/Full Time

Specials

  • • First Goal Scorer
  • • Cards & Corners
  • • Player Props

Rate Limits

Free Tier10 requests/minute
Starter Tier100 requests/minute
Pro Tier1,000 requests/minute
Business Tier5,000 requests/minute