4.5. GetPlacementInfo

This method retrieves the information such as latest odds, minimum and maximum amount that can be used to place a bet. The information given is similar to the BetPlacementWindow from the Asianodds Web platform. Default wait timeout (the time the call will wait for Bookie Responses) is 60 seconds. However, this can be overridden by using the Timeout parameter on the request body.

 

Request

Method

URL

Method

URL

POST

/AsianOddsService/GetPlacementInfo

REQUEST BODY

{
"GameId":{gameId from feed},
"GameType":"{H|O|X}",
"IsFullTime":{1|0},
"Bookies":"SIN,GA,..",
“MarketTypeId”:{0,1,2},
"OddsFormat":"{MY|00|HK}",
"OddsName":"{oddsName}",
"SportsType":{sportsType},
"Timeout":{timeout}
}

Type

Params

Values

Type

Params

Values

HEADER

AOToken

string

HEADER

Accept

application/json

REQUEST BODY

marketTypeId

int

REQUEST BODY

bookies

string

REQUEST BODY

isFullTime

int

REQUEST BODY

gameId

long

REQUEST BODY

gameType

string

REQUEST BODY

oddsName

string

REQUEST BODY

oddsFormat

string

REQUEST BODY

timeout

int

 

Request Values

Value

What is this for

Value

What is this for

AOToken

Token generated also by the Login method. This token identifies which user is requesting or executing the API Method. This has tobe sent for all of the request except during execution of the Login method

accept

application/json

marketTypeId

The ID of the market. This is 0 for Live, 1 for Today and 2 for Early.

bookies(required)

Specifies the bookies which will return the GetPlacementInfoResults.

isFullTime

1 if fulltime, 0 if not

gameId

GameID from the GetFeeds. Pertains to the Id from the game.

gameType

Type of game where the bets will place.
H is for HDP
O is for OverUnder
X is for 1X2 game

oddsName

Where the bets will be placed. Here are the valid values :
If GameType is H then :
● AwayOdds -Value of the AwayOdds from Feed under HDP
● HomeOdds -Value of Home Odds from Feed under HDP
If GameType is O then
● OverOdds -Value of OverOdds from Feed
● UnderOdds -Value of UnderOdds from Feed
If GameType is X then
● AwayOdds -Value of AwayOdds from Feed under OneXTwos
● DrawOdds -Value of DrawOdds from Feed under OneXTwos
● HomeOdds -Value of HomeOdds from Feed under OneXTwos

oddsId

ID of the Odds. Value is :
If GameType is H then ID under HDP
If GameType is O then ID under OU
If Gametype is X then ID under OneXTwos

oddsFormat(optional)

Format of Odds. Valid Value is :
MY
00
HK
If empty, then the default OddsFormat under GetUserInformation will be used.

timeout

Sometimes, when a request involves multiple bookies, some bookies takes time to return values, thereby holding up the performance or speed of returning the value, since this call will wait until either the default timeout (60 seconds) is reached or the bookie returned the values. When the default timeout (60 seconds) is reached and a particular bookie has not returned any response, the system will return whatever value it has received. This parameter overrides the 60 seconds default timeout. When specified, the system will wait until the specified value is reached, or all the bookies specified returned values and then returning whatever value it has received.

 

Response Values

Value

What is this for

Value

What is this for

Code

Holds the status of the response. If its 0, then it is successful. Negative values indicate failure

Awayname

Away Name

AwayScore

Away Score

Bookie

Bookie ID

Currency

Currency that will be used when a bet will be placed.

GameType

GameType where the bet will be placed

HDPOrGoal

Handicap or Goal Value

HomeName

Home Name

IsFullTime

True if the match is full time , false if otherwise

LeagueName

Name of the League

MarketTypeId

The ID of the market. This is 0 for Live, 1 for Today

and 2 for early.

 

MaximumAmount

Maximum Amount that can be placed

MinimumAmount

Minimum Amount that can be placed

Message

Message returned by the server

OddPlacementId

Unique ID of the returned bet placement information.

OddsFormat

Odds Format

Price

Price/Odds

Rejected

True if rejected, false otherwise

SportsType

SportsType of this placement data.

 

Sample JSON Response

Response Type

Response

Response Type

Response

Success

{
"Code": 0,
"Result": {
"OddsPlacementData": [
{
"AwayName": "Dong Thap U21",
"AwayScore": 0,
"Bookie": "ISN",
"Currency": "EUR",
"GameType": "H",
"HDPorGoal": "0.0",
"HomeName": "Hung Vuong An Giang U21 (N)",
"HomeOrAwayOrDraw": "H",
"HomeScore": 0,
"IsFullTime": true,
"LeagueName": "VIETNAM CHAMPIONSHIP U21 QUALIFIERS",
"MarketTypeId": 0,
"MaximumAmount": 133,
"Message": null,
"MinimumAmount": 3,
"OddPlacementId": "1476185140619",
"OddsFormat": null,
"Price": -0.81,
"Rejected": false,
"SportsType": 1
},
{
"AwayName": "Dong Thap U21",
"AwayScore": 0,
"Bookie": "IBC",
"Currency": "EUR",
"GameType": "H",
"HDPorGoal": "0.0",
"HomeName": "Hung Vuong An Giang U21 (N)",
"HomeOrAwayOrDraw": "H",
"HomeScore": 0,
"IsFullTime": true,
"LeagueName": "VIETNAM CHAMPIONSHIP U21 QUALIFIERS",
"MarketTypeId": 0,
"MaximumAmount": 169,
"Message": null,
"MinimumAmount": 2,
"OddPlacementId": "1476185140619",
"OddsFormat": "MY",
"Price": 0.65,
"Rejected": false,
"SportsType": 1
}
]
}
}

Fail

{
"Code": -1,
"Result": {
"AwayName": null,
"AwayScore": 0,
"Bookie": null,
"Curency": null,
"GameType": null,
"HDPorGoal": null,
"HomeName": null,
"HomeOrAwayOrDraw": null,
"HomeScore": 0,
"IsFullTime": false,
"LeagueName": null,
"MarketTypeId": 0,
"MaximumAmount": 0,
"Message": null,
"MinimumAmount": 0,
"OddPlacementId": null,
"OddsFormat": null,
"Price": 0,
"Rejected": false,
"SportsType": 0
}
}

 

 

Related pages