ODoddspapi
common

Get Markets

Changed on

List markets.

Lookup mode: marketIds OR sportId OR outcomeIds.

get/markets

Request

  • Base URL
    https://v5.oddspapi.io/en
  • URL
    https://v5.oddspapi.io/en/markets
  • Auth
    • API key in query parameter apiKey
    • or API key in header X-API-Key

Query parameters

marketIdsstring nullable

Comma- or space-separated market IDs.

sportIdinteger nullable

Single sport ID.

outcomeIdsstring nullable

Comma- or space-separated outcome IDs.

Response

Returns Market[]

marketIdinteger required

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

sportIdinteger nullable

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

marketTypestring nullable

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

periodstring nullable

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

marketLengthinteger nullable

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).

playerPropboolean nullable

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

handicapnumber nullable

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

marketNamestring nullable

Market display name, translated per the request language prefix.

marketNameShortstring nullable

Short market display name.

Changes

  • 9ca3a6a3c1e8Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status