Get Markets

curl --request GET \
  --url 'https://v5.oddspapi.io/en/markets?apiKey='

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://v5.oddspapi.io/en/markets?apiKey=",
  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://v5.oddspapi.io/en/markets?apiKey="

	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://v5.oddspapi.io/en/markets?apiKey=")

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

[
  {
    "marketId": 111,
    "marketLength": 2,
    "sportId": 11,
    "playerProp": false,
    "handicap": 0,
    "period": "result",
    "marketType": "moneyline",
    "marketName": "Winner (incl. overtime)",
    "marketNameShort": "Winner",
    "outcomes": [
      {
        "outcomeId": 111,
        "outcomeName": "1"
      },
      {
        "outcomeId": 112,
        "outcomeName": "2"
      }
    ]
  },
  {
    "marketId": 113,
    "marketLength": 3,
    "sportId": 11,
    "playerProp": false,
    "handicap": 0,
    "period": "fulltime",
    "marketType": "1x2",
    "marketName": "Regular Time Result",
    "marketNameShort": "1X2",
    "outcomes": [
      {
        "outcomeId": 113,
        "outcomeName": "1"
      },
      {
        "outcomeId": 114,
        "outcomeName": "X"
      },
      {
        "outcomeId": 115,
        "outcomeName": "2"
      }
    ]
  }
]

GET

markets

Get Markets

curl --request GET \
  --url 'https://v5.oddspapi.io/en/markets?apiKey='

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://v5.oddspapi.io/en/markets?apiKey=",
  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://v5.oddspapi.io/en/markets?apiKey="

	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://v5.oddspapi.io/en/markets?apiKey=")

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

[
  {
    "marketId": 111,
    "marketLength": 2,
    "sportId": 11,
    "playerProp": false,
    "handicap": 0,
    "period": "result",
    "marketType": "moneyline",
    "marketName": "Winner (incl. overtime)",
    "marketNameShort": "Winner",
    "outcomes": [
      {
        "outcomeId": 111,
        "outcomeName": "1"
      },
      {
        "outcomeId": 112,
        "outcomeName": "2"
      }
    ]
  },
  {
    "marketId": 113,
    "marketLength": 3,
    "sportId": 11,
    "playerProp": false,
    "handicap": 0,
    "period": "fulltime",
    "marketType": "1x2",
    "marketName": "Regular Time Result",
    "marketNameShort": "1X2",
    "outcomes": [
      {
        "outcomeId": 113,
        "outcomeName": "1"
      },
      {
        "outcomeId": 114,
        "outcomeName": "X"
      },
      {
        "outcomeId": 115,
        "outcomeName": "2"
      }
    ]
  }
]

Authorizations

apiKey

string

query

required

Your API key (query-based auth for v5).

Query Parameters

marketIds

string | null

Comma- or space-separated market IDs.

sportId

integer | null

Single sport ID.

outcomeIds

string | null

Comma- or space-separated outcome IDs.

Response

Returns Market[]

marketId

integer

required

Frozen market identifier — equal to the first (lowest) outcomeId of the market.

sportId

integer | null

Sport the market belongs to (also the first two digits of marketId).

marketType

string | null

Open market-type taxonomy value (e.g. 1x2, totals, spreads, players-shots). Stable per value, never exhaustive.

period

string | null

Generic period key the market settles on (see the period vocabulary in Enumerations).

marketLength

integer | null

Number of outcomes under this marketId - the sides that can be bet on, together forming the complete probability space (implied probabilities sum to ~1 before margin removal).

playerProp

boolean | null

True for player proposition markets — their odds rows carry a non-zero playerId.

handicap

number | null

Handicap / total line of the market. Each line is its own market (own marketId).

marketName

string | null

Market display name, translated per the request language prefix.

marketNameShort

string | null

Short market display name.

outcomes

object[]

The market's outcomes, in their canonical order.

Show child attributes

Getting Started

Reference

Get Markets

Authorizations

Query Parameters

Response