SoccersAPIDocsv2.2
Docs/Guides

Odds Formats

The odds_format parameter belongs only to /v2.2/fixtures/. If it is omitted, odds are returned in decimal format.

DEFAULTDecimaldecimalAlias: eu · Example: 2.50
UKFractionalfractionalAlias: uk · Example: 3/2
USAmericanamericanAlias: us · Example: +150

Direct odds operations

The examples use Premier League fixture 2589310 from season 21033 (2026/27).

GET /v2.2/fixtures/?t=match_odds&id=2589310&odds_format=uk
GET /v2.2/fixtures/?t=match_oddsinplay&id=2589310&odds_format=us
GET /v2.2/fixtures/?t=match_odds_info&id=2589310&bookmaker_id=1&odds_format=fractional

Odds included with fixtures

Use odds_format when a supported fixture operation includes odds_prematch, odds_inplay or both.

GET /v2.2/fixtures/?t=info&id=2589310&include=odds_prematch&odds_format=uk
GET /v2.2/fixtures/?t=info&id=2589310&include=odds_prematch,odds_inplay&bookmaker_ids=9,2&odds_format=us
GET /v2.2/fixtures/?t=season&season_id=21033&include=odds_prematch&odds_format=american

Compatible fixture operations are info, sort, schedule, season, round, today, tomorrow, yesterday, notstarted, inplay, ended, live and tv, where the selected operation and match coverage provide the requested odds dataset.

Filter and order bookmakers

bookmaker_ids is a comma-separated list. The API filters the included odds and preserves the supplied bookmaker order.

bookmaker_ids=9,2Two bookmakersReturns bookmaker 9 first, then bookmaker 2.
bookmaker_ids=9,3,1Custom priorityUseful when the product has a preferred display order.
bookmaker_ids=2Single bookmakerRestricts each included market to one bookmaker.

Use singular bookmaker_id only with t=match_odds_info.

Read in the reference