com.sportradar.sdk.feed.oddscreator.interfaces

Interface OddsCreatorFeed

public interface OddsCreatorFeed

The Betradar odds calculation web services will calculate a number of different odds types based on your match bet and total (over/under) odds. We offer a range of different odds types for several different sports.

Method Summary

Modifier and Type	Method and Description
List<IdNameEntity>	getCategories(int sportId) Returns a list of category ids and the corresponding descriptions we provide for a specified sport.
List<IdNameEntity>	getGenders() Returns a list of gender ids and the corresponding gender description used to calculate tennis odds.
List<IdNameEntity>	getOddsTypeIds(int sportId, boolean needMatchId) Returns a list of odds type ids and the corresponding odds type names.
List<IdNameEntity>	getOutcomeTypeIds(int sportId, int oddsTypeId) Returns a list of outcome type ids and the corresponding outcome type names.
List<OddsTypeEntity>	getSidebets(int sportId, List<Integer> oddsTypeIds, double homeOdds, double drawOdds, double awayOdds, double totalSpread, double overOdds, double underOdds) General special odds calculation.
List<OddsTypeEntity>	getSidebetsWithKey(int sportId, double homeOdds, double drawOdds, double awayOdds, double totalSpread, double overOdds, double underOdds, int oddsTypeId, double oddsKey) Special odds calculation with a given odds type id and odds key.
List<OddsTypeEntity>	getSidebetsWithMatchid(long matchId, List<Integer> oddsTypeIds, double homeOdds, double drawOdds, double awayOdds, double totalSpread, double overOdds, double underOdds) Special odds calculation with a given match id.
List<OddsTypeEntity>	getSidebetsWithMatchidAndKey(long matchId, double homeOdds, double drawOdds, double awayOdds, double totalSpread, double overOdds, double underOdds, int oddsTypeId, double oddsKey) Special odds calculation with a given match id, odds type and odds key.
List<OddsTypeEntity>	getSidebetsWithTournamentIdAndCategoryId(int sportId, int categoryId, int tournamentId, List<Integer> oddsTypeIds, double homeOdds, double drawOdds, double awayOdds, double totalSpread, double overOdds, double underOdds) Special odds calculation with a given tournament id and category id.
List<IdNameEntity>	getSports() Returns a list of sport ids and the corresponding sport names.
List<IdNameEntity>	getSurfaces() Returns a list of surface ids and the corresponding surface type names used to calculate tennis odds.
List<IdNameEntity>	getTennisMatchInfo(long matchId) Returns the tennis match info
List<OddsTypeEntity>	getTennisSidebets(double homeOdds, double awayOdds, int gender, int bestOfSets, int surface) This is a specific method to calculate tennis special odds.
List<OddsTypeEntity>	getTennisSidebetsWithKey(double homeOdds, double awayOdds, int gender, int bestOfSets, int surface, int oddsTypeId, double oddsKey) This method lets you request odds for tennis for a specific market, adjusted to the key you provide.
List<OddsTypeEntity>	getTennisSidebetsWithTournamentIdAndCategoryId(double homeOdds, double awayOdds, int gender, int bestOfSets, int surface, int categoryId, int tournamentId) Tennis special odds calculation with tournament id and category id.
List<IdNameEntity>	getTournaments(int categoryId) Returns a list of tournament ids and the corresponding tournament names.
List<OddsTypeEntity>	getVolleySidebets(int sportId, List<Integer> oddsTypeIds, double homeOdds, double drawOdds, double awayOdds, double totalSpread, double overOdds, double underOdds, int gender, int topLeague) (Beach) Volleyball special odds calculation
List<OddsTypeEntity>	getVolleySidebetsWithKey(int sportId, double homeOdds, double drawOdds, double awayOdds, double totalSpread, double overOdds, double underOdds, int gender, int topLeague, int oddsTypeId, double oddsKey) (Beach) Volleyball special odds calculation with odds type and odds key
List<OddsTypeEntity>	getVolleySidebetsWithTournamentIdAndCategoryId(int sportId, List<Integer> oddsTypeIds, double homeOdds, double drawOdds, double awayOdds, double totalSpread, double overOdds, double underOdds, int gender, int topLeague, int categoryId, int tournamentId) (Beach) Volleyball special odds calculation with tournament id and category id

Method Detail

getCategories

List<IdNameEntity> getCategories(int sportId)
                          throws OddsCreatorException

Returns a list of category ids and the corresponding descriptions we provide for a specified sport. This list represents the categories where we offer further odds calculation.

Parameters:

sportId - The sport id to fetch the categories from.

Returns:

Collection of ids and names of categories.

Throws:

OddsCreatorException - when any problem occurs

getGenders

List<IdNameEntity> getGenders()
                       throws OddsCreatorException

Returns a list of gender ids and the corresponding gender description used to calculate tennis odds.

Returns:

Collection of ids and names of genders.

Throws:

OddsCreatorException - when any problem occurs

getOddsTypeIds

List<IdNameEntity> getOddsTypeIds(int sportId,
                                  boolean needMatchId)
                           throws OddsCreatorException

Returns a list of odds type ids and the corresponding odds type names. This list represents the odds types we offer for each sport.

Parameters:

sportId - The sport id.

needMatchId - If set to false, only oddstypes that does not require , match id are returned, otherwise all available.

Returns:

Collection of ids and names of genders.

Throws:

OddsCreatorException - when any problem occurs

getOutcomeTypeIds

List<IdNameEntity> getOutcomeTypeIds(int sportId,
                                     int oddsTypeId)
                              throws OddsCreatorException

Returns a list of outcome type ids and the corresponding outcome type names. This list represents the outcomes we offer for a particular sport/odds typecombination.

Parameters:

sportId - The sport id.

oddsTypeId - The odds type id.

Returns:

Collection of ids and names of genders.

Throws:

OddsCreatorException - when any problem occurs

getSidebets

List<OddsTypeEntity> getSidebets(int sportId,
                                 List<Integer> oddsTypeIds,
                                 double homeOdds,
                                 double drawOdds,
                                 double awayOdds,
                                 double totalSpread,
                                 double overOdds,
                                 double underOdds)
                          throws OddsCreatorException

General special odds calculation.

This is the main method where most of the special odds are calculated. The odds keys are calculated according to the configuration set in betradar.com, or default values if none are set.

Parameters:

sportId - The internal Betradar sport id.

oddsTypeIds - List of ids corresponding to the odds type ids you want adjusted. (The possible odds type ids are described in detail in “Life Cycle of Odds” documentation, available in the download section at betradar.com). If the list is empty, all available odds types will be generated.

homeOdds - Your home team match bet odds.

drawOdds - Your draw match bet odds (set to 0.0 for sports where a draw outcome is not possible (Basketball, American Football, Baseball and so on).

awayOdds - Your away team match bet odds.

totalSpread - Your total odds spread.

overOdds - Your over odds.

underOdds - Your under odds.

Returns:

Collection of odds types

Throws:

OddsCreatorException - when any problem occurs

getSidebetsWithKey

List<OddsTypeEntity> getSidebetsWithKey(int sportId,
                                        double homeOdds,
                                        double drawOdds,
                                        double awayOdds,
                                        double totalSpread,
                                        double overOdds,
                                        double underOdds,
                                        int oddsTypeId,
                                        double oddsKey)
                                 throws OddsCreatorException

Special odds calculation with a given odds type id and odds key.

This method lets you request odds for a specific market, adjusted to the key you provide.

Parameters:

sportId - The sport id.

homeOdds - Your home team match bet odds.

drawOdds - Your draw match bet odds (set to 0.0 for sports where a draw outcome is not possible (Basketball, American Football, Baseball and so on).

awayOdds - Your away team match bet odds.

totalSpread - Your total odds spread.

overOdds - Your over odds.

underOdds - Your under odds.

oddsTypeId - The odds type you want adjusted.

oddsKey - The odds key you want your odds adjusted to.

Returns:

Collection of odds types

Throws:

OddsCreatorException - when any problem occurs

getSidebetsWithMatchid

List<OddsTypeEntity> getSidebetsWithMatchid(long matchId,
                                            List<Integer> oddsTypeIds,
                                            double homeOdds,
                                            double drawOdds,
                                            double awayOdds,
                                            double totalSpread,
                                            double overOdds,
                                            double underOdds)
                                     throws OddsCreatorException

Special odds calculation with a given match id.

This method follows the same as getSideBets, but based on a specific match. It adjusts the odds key according to the configuration set at betradar.com. Default values will be chosen if none are set explicitly.

Parameters:

matchId - The Betradar match id.

oddsTypeIds - List of ids corresponding to the odds type ids you want adjusted. (The possible odds type ids are described in detail in “Life Cycle of Odds” documentation, available in the download section at betradar.com). If the list is empty, all available odds types will be generated.

homeOdds - Your home team match bet odds.

drawOdds - Your draw match bet odds (set to 0.0 for sports where a draw outcome is not possible (Basketball, American Football, Baseball and so on).

awayOdds - Your away team match bet odds.

totalSpread - Your total odds spread.

overOdds - Your over odds.

underOdds - Your under odds.

Returns:

Collection of odds types

Throws:

OddsCreatorException - when any problem occurs

getSidebetsWithMatchidAndKey

List<OddsTypeEntity> getSidebetsWithMatchidAndKey(long matchId,
                                                  double homeOdds,
                                                  double drawOdds,
                                                  double awayOdds,
                                                  double totalSpread,
                                                  double overOdds,
                                                  double underOdds,
                                                  int oddsTypeId,
                                                  double oddsKey)
                                           throws OddsCreatorException

Special odds calculation with a given match id, odds type and odds key.

This method lets you request odds for a given match, for a specific market, adjusted to the key you provide.

Parameters:

matchId - The Betradar match id.

homeOdds - Your home team match bet odds.

drawOdds - Your draw match bet odds (set to 0.0 for sports where a draw outcome is not possible (Basketball, American Football, Baseball and so on).

awayOdds - Your away team match bet odds.

totalSpread - Your total odds spread.

overOdds - Your over odds.

underOdds - Your under odds.

oddsTypeId - The odds type you want adjusted.

oddsKey - The odds key you want your odds adjusted to.

Returns:

Collection of odds types

Throws:

OddsCreatorException - when any problem occurs

getSidebetsWithTournamentIdAndCategoryId

List<OddsTypeEntity> getSidebetsWithTournamentIdAndCategoryId(int sportId,
                                                              int categoryId,
                                                              int tournamentId,
                                                              List<Integer> oddsTypeIds,
                                                              double homeOdds,
                                                              double drawOdds,
                                                              double awayOdds,
                                                              double totalSpread,
                                                              double overOdds,
                                                              double underOdds)
                                                       throws OddsCreatorException

Special odds calculation with a given tournament id and category id.

This method follows the same as getSidebets. In addition it adjusts the odds key according to the configuration set at betradar.com, based on given tournament and / or category id. Default values will be chosen if none are set explicitly. To ignore either the tournament or category id, set id to 0.

Parameters:

sportId - The sport id.

categoryId - Id to indicate the category configuration we do calculations based upon. Set to 0 if category should not be taken into consideration.

tournamentId - Id to indicate the tournament configuration we do calculations based upon. Set to 0 if tournament should not be taken into consideration.

oddsTypeIds - List of ids corresponding to the odds type ids you want adjusted.(The possible odds type ids are described in detail in “Life Cycle of Odds” documentation, available in the download section at betradar.com). If the list is empty,all available odds types will be generated.

homeOdds - The home odds.

drawOdds - The draw odds.

awayOdds - The away odds.

totalSpread - The total spread.

overOdds - The over odds.

underOdds - The under odds.

Returns:

Collection of odds types

Throws:

OddsCreatorException - when any problem occurs

getSports

List<IdNameEntity> getSports()
                      throws OddsCreatorException

Returns a list of sport ids and the corresponding sport names. This list represents the sports where we offer further odds calculation.

Returns:

Collection of ids and names of sports.

Throws:

OddsCreatorException - when any problem occurs

getSurfaces

List<IdNameEntity> getSurfaces()
                        throws OddsCreatorException

Returns a list of surface ids and the corresponding surface type names used to calculate tennis odds.

Returns:

Collection of ids and names of surfaces.

Throws:

OddsCreatorException - when any problem occurs

getTennisSidebets

List<OddsTypeEntity> getTennisSidebets(double homeOdds,
                                       double awayOdds,
                                       int gender,
                                       int bestOfSets,
                                       int surface)
                                throws OddsCreatorException

This is a specific method to calculate tennis special odds. The tennis odds calculation requires other input parameters than the rest of the sports.

Parameters:

homeOdds - Your home team match bet odds.

awayOdds - Your away team match bet odds.

gender - Id to indicate if this is a match played by men or women.

bestOfSets - Specify if the match is best of 3 sets or best of 5 sets.

surface - Id to indicate what kind of surface the match is played on.

Returns:

Collection of odds types

Throws:

OddsCreatorException - when any problem occurs

getTennisSidebetsWithKey

List<OddsTypeEntity> getTennisSidebetsWithKey(double homeOdds,
                                              double awayOdds,
                                              int gender,
                                              int bestOfSets,
                                              int surface,
                                              int oddsTypeId,
                                              double oddsKey)
                                       throws OddsCreatorException

This method lets you request odds for tennis for a specific market, adjusted to the key you provide.

Parameters:

homeOdds - Your home team match bet odds.

awayOdds - Your away team match bet odds.

gender - Id to indicate if this is a match played by men or women.

bestOfSets - Specify if the match is best of 3 sets or best of 5 sets.

surface - Id to indicate what kind of surface the match is played on.

oddsTypeId - The odds type you want adjusted.

oddsKey - The odds key you want your odds adjusted to.

Returns:

Collection of odds types

Throws:

OddsCreatorException - when any problem occurs

getTennisSidebetsWithTournamentIdAndCategoryId

List<OddsTypeEntity> getTennisSidebetsWithTournamentIdAndCategoryId(double homeOdds,
                                                                    double awayOdds,
                                                                    int gender,
                                                                    int bestOfSets,
                                                                    int surface,
                                                                    int categoryId,
                                                                    int tournamentId)
                                                             throws OddsCreatorException

Tennis special odds calculation with tournament id and category id.

This method does the same as getTennisSidebets(homeOdds, awayOdds, gender, bestOfSets, surface). In addition it adjusts the odds key according to the configuration set at betradar.com, based on given tournament and / or category id. Default values will be chosen if none are set explicitly. To ignore either the tournament or category id, set id to 0.

Parameters:

homeOdds - Your home team match bet odds.

awayOdds - Your away team match bet odds.

gender - Id to indicate if this is a match played by men or women.

bestOfSets - Specify if the match is best of 3 sets or best of 5 sets.

surface - Id to indicate what kind of surface the match is played on.

categoryId - Id to indicate the category configuration we do calculations based upon. Set to 0 if category should not be taken into consideration.

tournamentId - Id to indicate the tournament configuration we do calculations based upon. Set to 0 if tournament should not be taken into consideration

Returns:

Collection of odds types

Throws:

OddsCreatorException - when any problem occurs

getTournaments

List<IdNameEntity> getTournaments(int categoryId)
                           throws OddsCreatorException

Returns a list of tournament ids and the corresponding tournament names. This list represents the tournaments for a specified category.

Parameters:

categoryId - The category id to get the tournaments in.

Returns:

Collection of ids and names of tournaments.

Throws:

OddsCreatorException - when any problem occurs

getVolleySidebets

List<OddsTypeEntity> getVolleySidebets(int sportId,
                                       List<Integer> oddsTypeIds,
                                       double homeOdds,
                                       double drawOdds,
                                       double awayOdds,
                                       double totalSpread,
                                       double overOdds,
                                       double underOdds,
                                       int gender,
                                       int topLeague)
                                throws OddsCreatorException

(Beach) Volleyball special odds calculation

This is a specific method to calculate volleyball / beach volleyball special odds. The odds calculation requires other input parameters than the rest of the sports.

Parameters:

sportId - the internal Betradar sport id. (23 for volleyball, or 34 for beach volleyball).

oddsTypeIds - a list of ids corresponding to the odds type ids you want calculated. (The possible odds type ids are described in detail in “Life Cycle of Odds” documentation, available in the download section at betradar.com. If the list is empty, all available odds types will be generated.

homeOdds - your home team match bet odds.

drawOdds - (double)– your draw match bet odds.

awayOdds - your away team match bet odds.

totalSpread - your total odds spread.

overOdds - your over odds.

underOdds - your under odds.

gender - id to indicate if this is a match played by men or women. (See section 3.4 for details).

topLeague - number to indicate whether it is a top league game or not.

Returns:

Collection of odds types

Throws:

OddsCreatorException - when any problem occurs

getVolleySidebetsWithKey

List<OddsTypeEntity> getVolleySidebetsWithKey(int sportId,
                                              double homeOdds,
                                              double drawOdds,
                                              double awayOdds,
                                              double totalSpread,
                                              double overOdds,
                                              double underOdds,
                                              int gender,
                                              int topLeague,
                                              int oddsTypeId,
                                              double oddsKey)
                                       throws OddsCreatorException

(Beach) Volleyball special odds calculation with odds type and odds key

This method lets you request odds for volleyball for a specific market, adjusted to the key you provide.

Parameters:

sportId - the internal Betradar sport id. (23 for volleyball, or 34 for beach volleyball).

homeOdds - your home team match bet odds.

drawOdds - (double)– your draw match bet odds.

awayOdds - your away team match bet odds.

totalSpread - your total odds spread.

overOdds - your over odds.

underOdds - your under odds.

gender - id to indicate if this is a match played by men or women.

topLeague - number to indicate whether it is a top league game or not.

oddsTypeId - the odds type you want calculated.

oddsKey - the odds key you want your odds adjusted to (greater than 99).

Returns:

Collection of odds types

Throws:

OddsCreatorException - when any problem occurs

getVolleySidebetsWithTournamentIdAndCategoryId

List<OddsTypeEntity> getVolleySidebetsWithTournamentIdAndCategoryId(int sportId,
                                                                    List<Integer> oddsTypeIds,
                                                                    double homeOdds,
                                                                    double drawOdds,
                                                                    double awayOdds,
                                                                    double totalSpread,
                                                                    double overOdds,
                                                                    double underOdds,
                                                                    int gender,
                                                                    int topLeague,
                                                                    int categoryId,
                                                                    int tournamentId)
                                                             throws OddsCreatorException

(Beach) Volleyball special odds calculation with tournament id and category id

This method does the same as getVolleySidebets. In addition it adjusts the odds key according to the configuration set at betradar.com, based on given tournament and / or category id. Default values will be chosen if none are set explicitly. To ignore either the tournament or category id, set id to 0.

Parameters:

sportId - the internal Betradar sport id. (23 for volleyball, or 34 for beach volleyball).

oddsTypeIds - a list of ids corresponding to the odds type ids you want calculated. (The possible odds type ids are described in detail in “Life Cycle of Odds” documentation, available in the download section at betradar.com. If the list is empty, all available odds types will be generated.

homeOdds - your home team match bet odds.

drawOdds - (double)– your draw match bet odds.

awayOdds - your away team match bet odds.

totalSpread - your total odds spread.

overOdds - your over odds.

underOdds - your under odds.

gender - id to indicate if this is a match played by men or women.

topLeague - number to indicate whether it is a top league game or not.

categoryId - id to indicate the category configuration we do calculations based upon. Set to 0 if category should not be taken into consideration.

tournamentId - id to indicate the tournament configuration we do calculations based upon. Set to 0 if tournament should not be taken into consideration.

Returns:

Collection of odds types

Throws:

OddsCreatorException - when any problem occurs

getTennisMatchInfo

List<IdNameEntity> getTennisMatchInfo(long matchId)
                               throws OddsCreatorException

Returns the tennis match info

Parameters:

matchId - id of the match

Returns:

Collection of ids and names of tennis match

Throws:

OddsCreatorException