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 */
]
}