Dropping Odds

Get Dropping Odds

Returns odds that have dropped significantly from their opening values. Data is pre-computed and updated every ~30 seconds. Results are sorted by the selected time window’s drop percentage (descending). Pagination metadata is returned in response headers (X-Total-Count, X-Page, X-Per-Page, X-Updated-At).

Data source selection:

If both sport and league are provided → reads league-specific data (all entries for that league)
If only sport is provided → reads sport-level data (top 200 per sport)
If neither → reads global data (top 500 across all sports)

Note: This endpoint requires a paid plan (Starter or above). Free plan users will receive a 403 error.

Note: leagues and league are mutually exclusive. leagues fetches from the sport- or global-level dataset and filters server-side.

GET

dropping-odds

Get Dropping Odds

curl --request GET \
  --url https://api.odds-api.io/v3/dropping-odds

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.odds-api.io/v3/dropping-odds",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.odds-api.io/v3/dropping-odds"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.odds-api.io/v3/dropping-odds")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "eventId": 69455182,
    "event": {
      "home": "Arsenal",
      "away": "Bournemouth",
      "date": "2026-04-12T15:00:00.000Z",
      "sport": {
        "name": "<string>",
        "slug": "<string>"
      },
      "league": {
        "name": "<string>",
        "slug": "<string>"
      }
    },
    "market": {
      "hdp": 123,
      "label": "<string>",
      "name": "<string>"
    },
    "betSide": "home",
    "odds": {
      "opening": 2.05,
      "current": 1.52,
      "drop": {
        "sinceOpening": 25.9,
        "12h": 8.4,
        "24h": 12.3,
        "48h": null
      }
    },
    "lastMovedAt": 1775851240182,
    "updatedAt": 1775854172851
  }
]

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

Query Parameters

apiKey

string

required

API key for authentication

sport

string

Sport slug (e.g. football, basketball)

league

string

League slug (e.g. england-premier-league). Requires sport param. Mutually exclusive with leagues.

leagues

string

Comma-separated league slugs to filter by multiple leagues at once (e.g. england-premier-league,spain-la-liga). Mutually exclusive with league.

markets

string

Comma-separated market names to filter by (case-insensitive). Supported: ML, Spread, Totals, Spread HT, Totals HT, Totals 1Q, Spread 1Q, Team Total Home, Team Total Away, First 5 Innings ML, First 5 Innings Spread, First 5 Innings Totals, Corners Spread, Corners Totals, Corners Spread HT, Corners Totals HT, Bookings Spread, Bookings Totals, Player Props

timeWindow

enum<string>

default:opening

Time window for drop filtering and sorting. Default: opening

Available options:

opening,

12h,

24h,

48h

minDrop

number

default:0

Minimum drop percentage for the selected time window. Default: 0

limit

integer

default:50

Maximum results per page (default 50, max 200)

Required range: x <= 200

page

integer

default:1

Page number, 1-indexed (default 1)

Required range: x >= 1

includeEventDetails

boolean

default:false

Include event details (home, away, date, sport, league). Default: false

Response

eventId

integer

Example:

69455182

event

object

Show child attributes

market

object

Show child attributes

betSide

enum<string>

Available options:

home,

away,

over,

under

Example:

"home"

odds

object

Show child attributes

lastMovedAt

integer | null

Unix milliseconds timestamp of last odds movement

Example:

1775851240182

updatedAt

integer

Unix milliseconds timestamp of last pipeline update

Example:

1775854172851

Get Dropping Odds

curl --request GET \
  --url https://api.odds-api.io/v3/dropping-odds

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.odds-api.io/v3/dropping-odds",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.odds-api.io/v3/dropping-odds"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.odds-api.io/v3/dropping-odds")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "eventId": 69455182,
    "event": {
      "home": "Arsenal",
      "away": "Bournemouth",
      "date": "2026-04-12T15:00:00.000Z",
      "sport": {
        "name": "<string>",
        "slug": "<string>"
      },
      "league": {
        "name": "<string>",
        "slug": "<string>"
      }
    },
    "market": {
      "hdp": 123,
      "label": "<string>",
      "name": "<string>"
    },
    "betSide": "home",
    "odds": {
      "opening": 2.05,
      "current": 1.52,
      "drop": {
        "sinceOpening": 25.9,
        "12h": 8.4,
        "24h": 12.3,
        "48h": null
      }
    },
    "lastMovedAt": 1775851240182,
    "updatedAt": 1775854172851
  }
]

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

Getting Started

API Reference

WebSocket

Get Dropping Odds

Query Parameters

Response