Odds

Get Odds Movements

Returns the prematch odds movements for one market line of an event from a bookmaker: the opening price, the latest price and recent price changes (how many are kept depends on the bookmaker feed). Market and bookmaker names are case-insensitive. A 404 explains what is missing and lists the markets or lines that do have history. History is recorded only for a fixed set of bookmakers: 10BET, 12bet, 1xbet, 22Bet, 888Sport, BC.Game, Bet365, Betano, Betclic FR, Betfair Exchange, Betfair Sportsbook, Betinia DK, BetMGM, Betsson, BetVictor, Betway, Bovada, Bwin ES, Bwin IT, CloudBet, ComeOn, Coolbet, DanskeSpil, DraftKings, Duel, Eurobet IT, FanDuel, FB Sports, GG.bet, Goldbet IT, Interwetten, Kalshi, Kambi, Ladbrokes, M88, Marathonbet, NetBet, NordicBet, Norsk Tipping, Novibet GR, ON Sharp, Paddy Power, Pamestoixima, Polymarket, Rollbit, Roobet, Sbobet, Sharp Exchange, SingBet, Sisal IT, Snai IT, SportyBet, Stake, Stoiximan, Superbet, Tipico DE, Tipsport.cz, Unibet, Unibet FR, Vbet, Veikkaus, William Hill, Winamax FR, and selected sharp books. Requesting a bookmaker outside this set returns a 404.

GET

odds

movements

Get Odds Movements

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.odds-api.io/v3/odds/movements",
  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/odds/movements"

	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/odds/movements")

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

{
  "bookmaker": "<string>",
  "eventid": "<string>",
  "latest": {
    "away": 123,
    "draw": 123,
    "hdp": "<string>",
    "home": 123,
    "max": 123,
    "timestamp": 123
  },
  "movements": [
    {
      "away": 123,
      "draw": 123,
      "hdp": "<string>",
      "home": 123,
      "max": 123,
      "timestamp": 123
    }
  ],
  "opening": {
    "away": 123,
    "draw": 123,
    "hdp": "<string>",
    "home": 123,
    "max": 123,
    "timestamp": 123
  }
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

Query Parameters

apiKey

string

required

API key for authentication

eventId

string

required

Event ID

bookmaker

string

required

Bookmaker name, case-insensitive (e.g. Bet365, SingBet, Bet365 (no latency))

market

string

required

Market name, case-insensitive (e.g. ML, Spread, Totals, Both Teams To Score)

marketLine

string

Handicap line (e.g. 0.5, -1.25, 2.5). Leave it out for the main line of Spread and Totals markets, where each entry's hdp shows the line at that time, or for markets without a line (ML, Draw No Bet, Both Teams To Score)

Response

bookmaker

string

eventid

string

latest

object

Show child attributes

movements

object[]

Show child attributes

opening

object

Show child attributes

Get Odds Movements

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.odds-api.io/v3/odds/movements",
  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/odds/movements"

	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/odds/movements")

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

{
  "bookmaker": "<string>",
  "eventid": "<string>",
  "latest": {
    "away": 123,
    "draw": 123,
    "hdp": "<string>",
    "home": 123,
    "max": 123,
    "timestamp": 123
  },
  "movements": [
    {
      "away": 123,
      "draw": 123,
      "hdp": "<string>",
      "home": 123,
      "max": 123,
      "timestamp": 123
    }
  ],
  "opening": {
    "away": 123,
    "draw": 123,
    "hdp": "<string>",
    "home": 123,
    "max": 123,
    "timestamp": 123
  }
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

Getting Started

API Reference

WebSocket

Get Odds Movements

Query Parameters

Response