4.4. GetFeeds

This method retrieves the feed or odds from the system.

 

Request

Method

URL

Method

URL

GET

/AsianOddsService/GetFeeds?sportsType={SportsType}&marketTypeId={marketTypeId}bookies={ALL|List of BookieID}&leagues={ALL|list of leagueId}&oddsFormat={MY|00|HK}&since={since}

Type

Params

Values

Type

Params

Values

HEADER

AOToken

string

HEADER

Accept

application/json

QUERY STRING

bookies

string

QUERY STRING

sportsType

int

QUERY STRING

leagues

String

QUERY STRING

oddsFormat

String

QUERY STRING

marketTypeId

int

QUERY STRING

since

long

 

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 to be sent for all of the request except during execution of the Login method

accept

application/json

Bookies(optional)

List of BookieID separated by comma(,). If you want all Bookies, then please use ALL keyword. Note that this is an optional field and without any value means that you have chosen ALL bookies.

sportsType(required)

Type of sports of which leagues to display. This is a required field. SportsType can be retrieved by calling GetSports.

Leagues(optional)

List of leagueID separated by comma(,). If you want all leagues, then either leave this empty or use ALL keyword.

oddsFormat(optional)

MY by default. Valid values are 00 for European Odds, MY for Malaysian odds, HK for Hongkong Odds

marketTypeId(required)

MarketTypeId refers to the type of market. Valid Values are {0,1,2}
0 : Live Market
1 : Today Market
2 : Early Market
If MarketTypeId is not specified, then 0 is the default value.

since(optional)

Since is a delta switch, and is actually the Since value returned when GetFeeds is called without the Since parameter. The value expected is a milliseconds since last epoch (or the similar Since value returned in GetFeeds).

When specified, the data returned are only the updated data that was generated since the value of this. This is normally used to return subset of data that have been updated, and you don't need to get the previous old data.

NOTE :When this parameter is not specified, and its the first time the GetFeeds was called, then it will return all the data. Otherwise, even if it is not specified, and the call to the GetFeeds is second time or more, then only the updated data will be returned.

 

Response Values

Value

What is this for

Value

What is this for

Code

Holds the status of the response. If it’s 0, then it is successful. Negative values indicate failures.

Since

Last Update on this feed in Milliseconds since last epoch

AwayTeam -Name

Name of the Away Team

AwayTeam -RedCards

Number of Red Cards

AwayTeam -Score

Score of the Away Team

ExpectedLength

Length of the game in minutes

FullTimeFavoured

Which is the Favourite team on Fulltime Game. If the value is 0 or 1, then the handicap is applied to the Home Team. If it is 2, then it is applied to the Away Team.

HalfTimeFavoured

Which is the Favourite team on Halftime Game. If the value is 0 or 1, then the handicap is applied to the Home Team. If it is 2, then it is applied to the Away Team.

GameId

ID of the Game

FullTimeHDP -BookieOdds

Odds for Both Home and Away as well as Best Odds described by Bookie.

FullTimeHDP -Handicap

Handicap

FullTimeOU -BookieOdds

Odds for Both Over and Under as well as Best Odds described by Bookie.

FullTimeOU -Goal

Goal

FullTimeOneXTwo -BookieOdds

Odds for Both Home, Away and Draw as well as Best Odds described by Bookie.

HalfTimeHDP -BookieOdds

Odds for Both Home and Away as well as Best Odds described by Bookie.

HalfTimeHDP -Handicap

Handicap

HalfTimeOU -BookieOdds

Odds for Both Over and Under as well as Best Odds described by Bookie.

HalfTimeOU -Goal

Goal

HalfTimeOneXTwo -BookieOdds

Odds for Both Home, Away and Draw as well as Best Odds described by Bookie.

InGameMinutes

In Game Minutes

IsLive

1 if the match is live, 0 if not

MarketType

Market Type in text. Values is “Live”, “Today” or “Early”

MarketTypeId

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

StartTime

StartTime or Kickoff Time in Milliseconds since last Epoch.

StartsOn

A converted date/time string of the StartTime

SportsType

SportsType ID

LeagueId

League ID

League Name

Name of the League

MatchID

ID of the Match

WillBeRemoved

True or False. True means that the Game has been removed from the Platform and therefore the consumer of the service should remove this from the reply and should not place a bet on this feed

ToBeRemovedOn

The datetime when the game will be removed from this feed in Milliseconds since last epoch. If HasBeenRemoved value is false, then this is -1.

IsActive

True or False. True means that you can place a bet on this game, false if otherwise.

UpdatedDateTime

Last time this particular match was updated in milliseconds since last epoch

 

Sample JSON Response

Response Type

Response

Response Type

Response

Success

{
"Code": 0,
"Result": {
"Since": 1473254981365,
"Sports": [
{
"MatchGames": [
{
"AwayTeam":{
"Name": "Ulinzi Stars",
"RedCards": 0,
"Score": 0,
},
"ExpectedLength": 45,
"FullTimeFavoured": 0,
"HalftTimeFavoured": 0,
"FullTimeHdp": {
"BookieOdds": "SIN=2.260,1.610;BEST=SIN 2.260,SIN 1.610",
"Handicap": "0.0"
},
"FullTimeOneXTwo": {
"BookieOdds": "SIN=2.260,1.610;BEST=SIN 2.260,SIN 1.610"
},
"FullTimeOu": {
"BookieOdds": "SIN=2.260,1.610;BEST=SIN 2.260,SIN 1.610",
"Goal": "0.5"
},
"GameId": 596092034,
"HalfTimeHdp": {
"BookieOdds": "",
"Handicap": ""
},
"HalfTimeOneXTwo": {
"BookieOdds": ""
},
"HalfTimeOu": {
"BookieOdds": "",
"Goal": ""
},
"HomeTeam": {
"Name": "Sony Sugar",
"RedCards": 0,
"Score": 0
},
"InGameMinutes": 139,
"IsActive": true,
"IsLive": 1,
"LeagueId": -155187273,
"LeagueName": "KENYA PREMIER LEAGUE",
"MarketType": "Live",
"MarketTypeId": 0,
"MatchId": -1748022697,
"StartTime": 1473249600000,
"StartsOn": "09/07/2016 12:00:00.000 PM",
"ToBeRemovedOn": -1,
"UpdatedDateTime": 1473254974947,
"WillBeRemoved": false
},
{
"AwayTeam": {
"Name": "Ulinzi Stars",
"RedCards": 0,
"Score": 0
},
"ExpectedLength": 45,
"FullTimeFavoured": 2,
"HalftTimeFavoured": 2,
"FullTimeHdp": {
"BookieOdds": "SIN=1.520,2.420;BEST=SIN 1.520,SIN 2.420",
"Handicap": "0-0.5"
},
"FullTimeOneXTwo": {
"BookieOdds": ""
},
"FullTimeOu": {
"BookieOdds": "SIN=1.520,2.420;BEST=SIN 1.520,SIN 2.420",
"Goal": "0.5-1"
},
"GameId": 214192611,
"HalfTimeHdp": {
"BookieOdds": "",
"Handicap": ""
},
"HalfTimeOneXTwo": {
"BookieOdds": ""
},
"HalfTimeOu": {
"BookieOdds": "",
"Goal": ""
},
"HomeTeam": {
"Name": "Sony Sugar",
"RedCards": 0,
"Score": 0
},
"InGameMinutes": 139,
"IsActive": true,
"IsLive": 1,
"LeagueId": -155187273,
"LeagueName": "KENYA PREMIER LEAGUE",
"MarketType": "Live",
"MarketTypeId": 0,
"MatchId": -1748022697,
"StartTime": 1473249600000,
"StartsOn": "09/07/2016 12:00:00.000 PM",
"ToBeRemovedOn": -1,
"UpdatedDateTime": 1473254974953,
"WillBeRemoved": false
},
{
"AwayTeam": {
"Name": "ECU Joondalup",
"RedCards": 0,
"Score": 2
},
"ExpectedLength": 45,
"FullTimeFavoured": 0,
"HalftTimeFavoured": 0,
"FullTimeHdp": {
"BookieOdds": "SIN=1.720,2.130;BEST=SIN 1.720,SIN 2.130",
"Handicap": "0.0"
},
"FullTimeOneXTwo": {
"BookieOdds": "SIN=1.720,2.130;BEST=SIN 1.720,SIN 2.130"
},
"FullTimeOu": {
"BookieOdds": "SIN=1.720,2.130;BEST=SIN 1.720,SIN 2.130",
"Goal": "3.5"
},
"GameId": -643483232,
"HalfTimeHdp": {
"BookieOdds": "",
"Handicap": ""
},
"HalfTimeOneXTwo": {
"BookieOdds": ""
},
"HalfTimeOu": {
"BookieOdds": "",
"Goal": ""
},
"HomeTeam": {
"Name": "Inglewood United",
"RedCards": 0,
"Score": 0
},
"InGameMinutes": 60,
"IsActive": true,
"IsLive": 1,
"LeagueId": 1350816037,
"LeagueName": "WESTERN AUSTRALIA NATIONAL PREMIER LEAGUE – PLAYOFF",
"MarketType": "Live",
"MarketTypeId": 0,
"MatchId": -1131881881,
"StartTime": 1473251400000,
"StartsOn": "09/07/2016 12:30:00.000 PM",
"ToBeRemovedOn": -1,
"UpdatedDateTime": 1473254980960,
"WillBeRemoved": false
},
{
"AwayTeam": {
"Name": "Russia",
"RedCards": 0,
"Score": 0
},
"ExpectedLength": 45,
"FullTimeFavoured": 0,
"HalftTimeFavoured": 0,
"FullTimeHdp": {
"BookieOdds": "SIN=1.910,1.790;BEST=SIN 1.910,SIN 1.790",
"Handicap": "4.5"
},
"FullTimeOneXTwo": {
"BookieOdds": ""
},
"FullTimeOu": {
"BookieOdds": "SIN=1.910,1.790;BEST=SIN 1.910,SIN 1.790",
"Goal": "9.5"
},
"GameId": -1678831951,
"HalfTimeHdp": {
"BookieOdds": "",
"Handicap": ""
},
"HalfTimeOneXTwo": {
"BookieOdds": ""
},
"HalfTimeOu": {
"BookieOdds": "",
"Goal": ""
},
"HomeTeam": {
"Name": "Moldova",
"RedCards": 0,
"Score": 0
},
"InGameMinutes": 60,
"IsActive": false,
"IsLive": 1,
"LeagueId": -482280716,
"LeagueName": "FIFA BEACH SOCCER WORLD CUP 2017 EUROPE QUALIFICATION (IN ITALY)",
"MarketType": "Live",
"MarketTypeId": 0,
"MatchId": -2063370818,
"StartTime": 1473254100000,
"StartsOn": "09/07/2016 01:15:00.000 PM",
"ToBeRemovedOn": 1473255135286,
"UpdatedDateTime": 1473254835286,
"WillBeRemoved": true
},
{
"AwayTeam": {
"Name": "ECU Joondalup",
"RedCards": 0,
"Score": 2
},
"ExpectedLength": 45,
"FullTimeFavoured": 0,
"HalftTimeFavoured": 0,
"FullTimeHdp": {
"BookieOdds": "SIN=2.060,1.780;BEST=SIN 2.060,SIN 1.780",
"Handicap": "0-0.5"
},
"FullTimeOneXTwo": {
"BookieOdds": ""
},
"FullTimeOu": {
"BookieOdds": "SIN=2.060,1.780;BEST=SIN 2.060,SIN 1.780",
"Goal": "3.5-4"
},
"GameId": -107357070,
"HalfTimeHdp": {
"BookieOdds": "",
"Handicap": ""
},
"HalfTimeOneXTwo": {
"BookieOdds": ""
},
"HalfTimeOu": {
"BookieOdds": "",
"Goal": ""
},
"HomeTeam": {
"Name": "Inglewood United",
"RedCards": 0,
"Score": 0
},
"InGameMinutes": 60,
"IsActive": true,
"IsLive": 1,
"LeagueId": 1350816037,
"LeagueName": "WESTERN AUSTRALIA NATIONAL PREMIER LEAGUE – PLAYOFF",
"MarketType": "Live",
"MarketTypeId": 0,
"MatchId": -1131881881,
"StartTime": 1473251400000,
"StartsOn": "09/07/2016 12:30:00.000 PM",
"ToBeRemovedOn": -1,
"UpdatedDateTime": 1473254981365,
"WillBeRemoved": false
}
],
"SportsType": 1
},
],
},
}

Fail

{
"Code": -1,
"Result": null
}

Related pages