Skip to main content

4.4 Positions Requests

Informative API calls allowing to explore the payout grid of bet types.

Available calls:

4.4.1 Return information about a bet type, including win/loss grid​

Method and URL:

GET /v1/sports/<sport>/bet_types/<bet_type>/

The win/loss grid is a grid, usually 10 × 10 elements, representing the result of a bet of the given type according to the result. The element position[M][N] represents the outcome of the bet if the result is home: M, away: N. Each element can be:

  • w: the bet is winning;
  • l: the bet is losing;
  • v: the bet is refunded (e.g. a result 0-0 for a football bet of type for,ah,h,0);
  • v/w: half of the stake is winning, half refunded (e.g. a result 0-0 for a football bet of type for,ah,h,1) ;
  • l/v: half of the stake is losing, half refunded (e.g. a result 0-0 for a football bet of type for,ah,h,-1).

URL Parameters:

sport:

The code of the sport.

bet_type:

The code of the bet type.

Request Parameters:

home_team [ string ] (optional):

The name of the home team, to include in the human-readable bet type name, if useful.

away_team [ string ] (optional):

The name of the away team, to include in the human-readable bet type name, if useful.

Output Format:

sport [ string ]:

The human-readable name of the sport.

bet_type_description [ string ]:

The human-readable name of the bet type.

position [ list[list[string, ...], ...] ] (optional):

The win/loss code for each outcome of the bet.

Example:

The GET request:

/v1/sports/fb/bet_types/for,ah,h,3/?home_team=Arsenal&away_team=Liverpool

could return the following structure:

{
  "sport": "Football Full Time",
  "bet_type_description": "Arsenal +0.5/1 (Asian)",
  "winloss_grid": [
    ["w", "l/v", "l",   "l",   /* other 6 codes */ ],
    ["w", "w",   "l/v", "l",   /* other 6 codes */ ],
    ["w", "w",   "w",   "l/v", /* other 6 codes */ ],
    ["w", "w",   "w",   "w",   /* other 6 codes */ ],
    /* other 6 rows */
  ]
}