TXODDS Pre-game Feed Horse Racing Edition User Guide Document version 4.02 August 2015
Table of Contents TXODDS PRE-GAME FEED... 1 HORSE RACING EDITION... 1 TABLE OF CONTENTS... 2 WHAT ARE THE TXODDS XML FEEDS?... 3 Time sensitivity... 3 Data on demand... 4 SUBSCRIPTION... 4 Contact details... 4 Error Reporting... 4 HORSE RACING... 5 XML FEED... 5 Base URL... 5 Authentication... 5 REQUESTING ODDS DATA... 5 Race Fixtures and Odds... 6 XML DOCUMENT STRUCTURE... 9 XML Declaration... 10 Races Container... 10 Race element... 11 Example <race> element... 11 Bookmaker element... 11 Example <bookmaker> element... 12 Horse element... 12 Example <horse> element... 12 Offer element... 13 Example <offer> element... 13 Example full document... 13 APPENDIX 1 BOOKMAKERS... 15 APPENDIX 2 COURSES (GROUPS) WEBSERVICE... 16 FILTERING... 17 Master Group ID... 17 Year/Season ID... 18 League ID/Pgid... 18 APPENDIX 3 MASTER GROUPS WEBSERVICE... 20 APPENDIX 4 SPORTS WEBSERVICE... 23 APPENDIX 5 - COUNTRIES WEBSERVICE... 24 DOCUMENT HISTORY... 25 CHANGES... 25 Version 3.00 New Features... 25 Version 3.01 New Features... 25 Version 4.01 New Features... 25 Version 4.02 New Features... 25 Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 2 of 25
What are the TXODDS XML Feeds? The TXODDS AHC master database is constantly updated with the latest Horse Racing odds from a selection of bookmakers and races from around the world. For the first release of the feed we are providing:- Time sensitivity Worldwide Specialist bookmakers Race Win and Place market odds Live odds - utilising our unique in-house technology, updates are available on a second-by-second basis Each price update available with timestamp The AHC Horse Racing feed provides a single web service for both fixtures and bookmaker odds <races time="2015-08-03 23:53:45" timestamp="1438617225"> <race mid="50238" tipex-matchid="54292" xsid="0" lastupdate="2015-08-03 10:57:16" Live="0"> <time>2015-08-03t15:55:00</time> <group id="20502">hrukinaas</group> <bookmaker name="bet365" Place="1/4" Rank="3"> <horse id="206870" horse="pretty Famous"> <offer id="5044793" ot="win" price="13" recdate="2015-08-03 15:49:43"/> <horse id="208949" horse="staccato Wolf"> <offer id="5044805" ot="win" price="17" recdate="2015-08-03 15:49:44"/> <horse id="211308" horse="taggsisland"> <offer id="5044787" ot="win" price="6.5" recdate="2015-08-03 15:49:43"/> <offer id="5045089" ot="win" price="6" recdate="2015-08-03 15:51:09"/> <offer id="5045259" ot="win" price="5.5" recdate="2015-08-03 15:52:36"/> <horse id="211315" horse="baunaniska"> <offer id="5044795" ot="win" price="21" recdate="2015-08-03 15:49:44"/> <offer id="5045071" ot="win" price="26" recdate="2015-08-03 15:50:58"/> <horse id="214230" horse="the Fairy"> <offer id="5044790" ot="win" price="8" recdate="2015-08-03 15:49:43"/> <horse id="214487" horse="standinthesunlight"> <offer id="5044802" ot="win" price="26" recdate="2015-08-03 15:49:44"/> <horse id="216371" horse="william Ashford"> <offer id="5044804" ot="win" price="26" recdate="2015-08-03 15:49:44"/> <horse id="217890" horse="double Fast"> <offer id="5044799" ot="win" price="11" recdate="2015-08-03 15:49:44"/> <horse id="217913" horse="beechmount Whisper"> <offer id="5044657" ot="win" price="3" recdate="2015-08-03 15:48:53"/> <offer id="5044792" ot="win" price="3.25" recdate="2015-08-03 15:49:43"/> <offer id="5044852" ot="win" price="3" recdate="2015-08-03 15:49:59"/> <offer id="5044925" ot="win" price="2.87" recdate="2015-08-03 15:50:24"/> <offer id="5045138" ot="win" price="3" recdate="2015-08-03 15:51:33"/> <horse id="219088" horse="mixin N Scratchin"> <offer id="5044801" ot="win" price="26" recdate="2015-08-03 15:49:44"/> <horse id="234035" horse="in The Dark"> <offer id="5045024" ot="win" price="21" recdate="2015-08-03 15:50:47"/> <horse id="261759" horse="volt"> <offer id="5044970" ot="win" price="17" recdate="2015-08-03 15:50:37"/> Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 3 of 25
<horse id="263772" horse="benjalina"> <offer id="5044789" ot="win" price="9" recdate="2015-08-03 15:49:43"/> <offer id="5044937" ot="win" price="8.5" recdate="2015-08-03 15:50:27"/> <offer id="5045079" ot="win" price="9" recdate="2015-08-03 15:51:03"/> <offer id="5045235" ot="win" price="10" recdate="2015-08-03 15:52:22"/> <horse id="267517" horse="athloman Cottage"> <offer id="5044798" ot="win" price="13" recdate="2015-08-03 15:49:44"/> <offer id="5045072" ot="win" price="11" recdate="2015-08-03 15:50:58"/> <offer id="5045113" ot="win" price="9" recdate="2015-08-03 15:51:24"/> <offer id="5045196" ot="win" price="8" recdate="2015-08-03 15:52:07"/> <horse id="541321" horse="brutally Honest"> <offer id="5044796" ot="win" price="26" recdate="2015-08-03 15:49:44"/> </bookmaker> All odds updates since your last request can be made so that extremely fast updates to odds quotes can be received with minimal processing overhead as only the information you need is sent Data on demand Unlike scraping your own data you don t need to request everything from the bookmakers unless you want it. For example you can request information by:- bookmaker i.e. only William Hill, or Bet365 and Ladbrokes only by time i.e. by requesting the only updated odds by course i.e. only races at Kempton Park for example Of course if you want all matches for each of the odds types we offer and all bookmakers currently being quoted then you can have that too. To see a comprehensive list of what s available please see Appendix 1 Bookmaker for all bookmakers supported Error! Reference source not found. for all courses available Subscription In order to subscribe to the XML Feed or request a trial access period please contact TXODDS via the methods below Contact details For further details, please contact us at xml@txodds.com You can also leave your details on our 24 hour customer support messaging service on telephone +44 870 429 5280 (UK callers: 0870-429 5280) and a representative will be in touch as soon as possible. Error Reporting For any live service related issues we have a 24 hour email support service available at ahc@txodds.com and via Skype username: ahcasiaservices Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 4 of 25
Horse Racing XML Feed description Base URL The base XML documents can be found at the following URLs http://ahceur2.txodds.com European Horse Racing Live feed server http://ahchk2.txodds.com Backup server/ Asian primary server Either server can be used as a live primary or live back depending on whether your main access point is from Europe or Asia. In order to access the feed you will need a valid TXODDS username and password Authentication As the AHC Feed is configured on a per account based system, all files requested must be tagged with your specific user name and password to gain access. Additionally access is restricted by the IP address of the computer which will read the feed data. This IP address must be registered with TXODDS before you can access the feed(s) You will be assigned a unique username and password once you setup a TXODDS user account and subscribe to the XML Feed service. Please contact us via the Contact details section for more information. Requesting Odds Data It is very important to understand how to request the odds data correctly to ensure you get the best possible performance and reliable data. On many systems data can be locally cached to improve performance but this is obviously something you do not want for real-time data collection. TXODDS provide the timestamp request feature to ensure no data is cached and you have the very latest data from our servers at all times. The sequence for requesting data should be as follows:- 1. Make your initial request for the type of odds you require to prime your odds database ( or memory array,table etc.) e.g. http://ahceur2.txodds.com/oddsdata/db/horsexml2.asp Note: the authentication strings are removed for clarify) 2. Now record the server s timestamp (Timestamp=) returned for each of the above calls Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 5 of 25
<races time='2013-02-25 14:36:53' timestamp='1361774213'> 3. Use the recorded timestamp for each of the previous calls for your next calls:- http://ahceur2.txodds.com/oddsdata/db/horsexml2.asp?last=1361774213 4. Continue to use the &last=timestamp for all subsequent calls for odds updates Race Fixtures and Odds Requesting the latest racing odds The Horse Racing feed combines both the course/race fixtures with the bookmakers odds into a single feed for ease of use. To populate your local database with the last odds for each race you need to make a single request USAGE http://ahceur2.txodds.com/oddsdata/db/horsexml2.asp Example http://ahceur2.txodds.com/oddsdata/db/horsexml2.asp?userid=username&passid=passwd Example 1 All Racing Odds Exampl e http://ahceur2.txodds.com/oddsdata/db/horsexml2.asp?userid=username&passid=passwd <races time="2015-08-03 23:53:45" timestamp="1438617225"> <race mid="50238" tipex-matchid="54292" xsid="0" lastupdate="2015-08-03 10:57:16" Live="0"> <time>2015-08-03t15:55:00</time> <group id="20502">hrukinaas</group> <bookmaker name="bet365" Place="1/4" Rank="3"> <horse id="206870" horse="pretty Famous"> <offer id="5044793" ot="win" price="13" recdate="2015-08-03 15:49:43"/> <horse id="208949" horse="staccato Wolf"> <offer id="5044805" ot="win" price="17" recdate="2015-08-03 15:49:44"/> <horse id="211308" horse="taggsisland"> <offer id="5044787" ot="win" price="6.5" recdate="2015-08-03 15:49:43"/> <offer id="5045089" ot="win" price="6" recdate="2015-08-03 15:51:09"/> <offer id="5045259" ot="win" price="5.5" recdate="2015-08-03 15:52:36"/> <horse id="211315" horse="baunaniska"> <offer id="5044795" ot="win" price="21" recdate="2015-08-03 15:49:44"/> <offer id="5045071" ot="win" price="26" recdate="2015-08-03 15:50:58"/> <horse id="214230" horse="the Fairy"> <offer id="5044790" ot="win" price="8" recdate="2015-08-03 15:49:43"/> <horse id="214487" horse="standinthesunlight"> <offer id="5044802" ot="win" price="26" recdate="2015-08-03 15:49:44"/> </bookmaker> </race> {. etc } </races> Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 6 of 25
Request updates only To request the odds quote from a specified time you can use the TimeStamp request option. Please see the Requesting Odds Data section for processing guidelines. To know the latest odds update you need to track the TimeStamp attribute in the document root <races time="2015-08-12 20:13:22" timestamp="1439381602"> USAGE http://ahceur2.txodds.com/oddsdata/db/horsexml2.asp Example http://ahceur2.txodds.com/oddsdata/db/horsexml2.asp?userid=username&passid=passwd &last=1439381602 Example 1 All updates only This will request all odds updates since Wed, 12 Aug 2015 12:13:22 (GMT) Exampl e http://ahceur2.txodds.com/oddsdata/db/horsexml2.asp?userid=username&passid=pass wd&last=1439381602 Note: Please only use timestamps returned from our server on a previous request when using the &last= option. The timestamp is based upon the last time ( on our server) that an update was applied, so if a customer generates their own servers time updates can be missed. <races time="2015-08-12 20:14:41" timestamp="1439381681"> <race mid="51588" tipex-matchid="55647" xsid="0" lastupdate="2015-08-12 03:26:22" Live="0"> <time>2015-08-12t13:20:00</time> <group id="20464">hrukisalisbury</group> <bookmaker name="bet365" Place="1/5" Rank="3"> <horse id="556524" horse="zapped"> <offer id="5823181" ot="win" price="10" recdate="2015-08-12 12:13:06"/> <offer id="5823189" ot="win" price="11" recdate="2015-08-12 12:13:23"/> <horse id="560647" horse="taneen"> <offer id="5823188" ot="win" price="2.87" recdate="2015-08-12 12:13:23"/> </bookmaker> </race> <race mid="51573" tipex-matchid="55634" xsid="0" lastupdate="2015-08-12 03:25:08" Live="0"> <time>2015-08-12t14:35:00</time> <group id="20452">hrukibeverley</group> <bookmaker name="bet365" Place="1/4" Rank="3"> <horse id="142230" horse="even Stevens"> <offer id="5823166" ot="win" price="17" recdate="2015-08-12 12:12:33"/> </bookmaker> </race> <race mid="51562" tipex-matchid="55629" xsid="0" lastupdate="2015-08-12 03:25:08" Live="0"> <time>2015-08-12t15:05:00</time> <group id="20452">hrukibeverley</group> <bookmaker name="coral" Place="" Rank="0"> <horse id="135938" horse="arizona John"> <offer id="5823156" ot="win" price="4.5" recdate="2015-08-12 12:12:23"/> <horse id="207018" horse="old Fashion"> <offer id="5823158" ot="win" price="9.5" recdate="2015-08-12 12:12:24"/> Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 7 of 25
<horse id="214225" horse="bold Appeal"> <offer id="5823157" ot="win" price="1.62" recdate="2015-08-12 12:12:24"/> </bookmaker> <bookmaker name="ladbrokes" Place="1/4" Rank="2"> <horse id="208584" horse="nickscreamcracker"> <offer id="5823173" ot="win" price="9" recdate="2015-08-12 12:12:40"/> </bookmaker> </race> <race mid="51586" tipex-matchid="55663" xsid="0" lastupdate="2015-08-12 03:26:01" Live="0"> <time>2015-08-12t15:50:00</time> <group id="20440">hrukinewtonabbot</group> <bookmaker name="victor" Place="1/5" Rank="3"> <horse id="162630" horse="louis Phillipe"> <offer id="5823183" ot="win" price="3.5" recdate="2015-08-12 12:13:08"/> </bookmaker> </race> </races> Etc Note: Here you can see changed odds (delta updates) for a variety of races, bookmakers and horses, so each of these can be applied to your application/database based upon an index comprising of:- race mid= ( a unique id code for each race ) bookmaker name ( text/string name of the bookmaker) horse id= ( a unique horse/competitor id code offer id= ( a unique id code for each bookmaker offer it is unique across all races, horses ) recdate= ( the time the odds we found/updated) Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 8 of 25
XML Document structure The XML document is structurally rather simple containing 2 main elements ( match & odds) plus 2 sub-elements (status & scores) within the Odds container. All quoted odds information is held within this element. The XML document is made up of the following three elements:- XML Declaration Races Container Race Element Bookmakers Element consisting of o Horse id and name o Offer id, odds type and price & updated time These are all comprehensively described below. xml declaration Races container Race element Race element mid Tipex-matchid xsid lastupdate Live time group id mid Tipex-matchid xsid lastupdate Live time group id Bookmaker element name horse id= name= Bookmaker element name horse id= name= horse element id= name= offer element id= ot= price= recate= horse element id= name= horse element offer element id= name= id= ot= price= recdate= Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 9 of 25
XML Declaration <?xml version="1.0" encoding="utf-8 "?>?xml version= While XML documents are not required to begin with an XML declaration, it is generally good practice to do so. The declaration says "This is an XML document" and specifies the version thereof -- the current version of XML itself is 1.0. So the first line of our document looks like this: <?xml version="1.0" encoding="utf-8"?> Races Container All requests to the TXODDS XML feed will return an XML document with the races container or root element of which there can be only one outer container. <races time="2015-08-12 20:14:41" timestamp="1439381681"> <race mid="51588" tipex-matchid="55647" xsid="0" lastupdate="2015-08-12 03:26:22" Live="0"> <time>2015-08-12t13:20:00</time> <group id="20464">hrukisalisbury</group> <bookmaker name="bet365" Place="1/5" Rank="3"> <horse id="556524" horse="zapped"> <offer id="5823181" ot="win" price="10" recdate="2015-08-12 12:13:06"/> <offer id="5823189" ot="win" price="11" recdate="2015-08-12 12:13:23"/> <horse id="560647" horse="taneen"> <offer id="5823188" ot="win" price="2.87" recdate="2015-08-12 12:13:23"/> </bookmaker> </race> timestamp The Unix timestamp corresponding to the server time that this request was processed time The actual server time ELEMENTS race The race element describes individual races information such as the date, start time, country code/race course name Multiple sub-elements are allowed If the request returns no data (i.e. no updates have been received) or it is invalid for some reason you will still receive an XML document with valid XML Declaration and match container as above but it will of course not contain any data. Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 10 of 25
Race element ELEMENTS mid Unique race id code Tipex-matchid TXODDS unique race id ( for the XML2 feed) xsid Not used lastupdate Last time the fixture data was changed Live Whether odds will update once the race starts. Note: Currently this will be 0 i.e. before the start only bookmaker The bookmaker element describes individual bookmakers offers for each horse Multiple sub-elements are allowed Example <race> element This is a simple example of the match <race> element <race mid="51588" tipex-matchid="55647" xsid="0" lastupdate="2015-08-12 03:26:22" Live="0"> <time>2015-08-12t13:20:00</time> <group id="20464">hrukisalisbury</group> <bookmaker name="bet365" Place="1/5" Rank="3"> <horse id="556524" horse="zapped"> <offer id="5823181" ot="win" price="10" recdate="2015-08-12 12:13:06"/> <offer id="5823189" ot="win" price="11" recdate="2015-08-12 12:13:23"/> <horse id="560647" horse="taneen"> <offer id="5823188" ot="win" price="2.87" recdate="2015-08-12 12:13:23"/> </bookmaker> </race> Bookmaker element name= Bookmaker name horse The horse element describes individual horse names, id Multiple sub-elements are allowed Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 11 of 25
Example <bookmaker> element This is a simple example of the match <horse> element <races time="2015-08-12 20:14:41" timestamp="1439381681"> <race mid="51588" tipex-matchid="55647" xsid="0" lastupdate="2015-08-12 03:26:22" Live="0"> <time>2015-08-12t13:20:00</time> <group id="20464">hrukisalisbury</group> <bookmaker name="bet365" Place="1/5" Rank="3"> <horse id="556524" horse="zapped"> <offer id="5823181" ot="win" price="10" recdate="2015-08-12 12:13:06"/> <offer id="5823189" ot="win" price="11" recdate="2015-08-12 12:13:23"/> <horse id="560647" horse="taneen"> <offer id="5823188" ot="win" price="2.87" recdate="2015-08-12 12:13:23"/> </bookmaker> </race> Horse element id= Unique id code for the horse norse= The horses name Offer element The offerelement describes individual horse offers /prices Multiple sub-elements are allowed Example <horse> element This is a simple example of the match <horse> element <races time="2015-08-03 23:53:45" timestamp="1438617225"> <race mid="50238" tipex-matchid="54292" xsid="0" lastupdate="2015-08-03 10:57:16" Live="0"> <time>2015-08-03t15:55:00</time> <group id="20502">hrukinaas</group> <bookmaker name="bet365" Place="1/4" Rank="3"> <horse id="206870" horse="pretty Famous"> <offer id="5044793" ot="win" price="13" recdate="2015-08-03 15:49:43"/> <horse id="208949" horse="staccato Wolf"> <offer id="5044805" ot="win" price="17" recdate="2015-08-03 15:49:44"/> <horse id="211308" horse="taggsisland"> <offer id="5044787" ot="win" price="6.5" recdate="2015-08-03 15:49:43"/> <offer id="5045089" ot="win" price="6" recdate="2015-08-03 15:51:09"/> <offer id="5045259" ot="win" price="5.5" recdate="2015-08-03 15:52:36"/> <horse id="211315" horse="baunaniska"> <offer id="5044795" ot="win" price="21" recdate="2015-08-03 15:49:44"/> <offer id="5045071" ot="win" price="26" recdate="2015-08-03 15:50:58"/> <horse id="214230" horse="the Fairy"> <offer id="5044790" ot="win" price="8" recdate="2015-08-03 15:49:43"/> Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 12 of 25
Offer element id= Unique id code for the horse ot= The market name for the odds Note: Initially this is just the WIN market price= The current odds for this horse/market recdate= The time the odds were extracted/updated Example <offer> element This is a simple example of the match <horse> element <races time="2015-08-03 23:53:45" timestamp="1438617225"> <race mid="50238" tipex-matchid="54292" xsid="0" lastupdate="2015-08-03 10:57:16" Live="0"> <time>2015-08-03t15:55:00</time> <group id="20502">hrukinaas</group> <bookmaker name="bet365" Place="1/4" Rank="3"> <horse id="206870" horse="pretty Famous"> <offer id="5044793" ot="win" price="13" recdate="2015-08-03 15:49:43"/> <horse id="208949" horse="staccato Wolf"> <offer id="5044805" ot="win" price="17" recdate="2015-08-03 15:49:44"/> <horse id="211308" horse="taggsisland"> <offer id="5044787" ot="win" price="6.5" recdate="2015-08-03 15:49:43"/> <offer id="5045089" ot="win" price="6" recdate="2015-08-03 15:51:09"/> <offer id="5045259" ot="win" price="5.5" recdate="2015-08-03 15:52:36"/> <horse id="211315" horse="baunaniska"> <offer id="5044795" ot="win" price="21" recdate="2015-08-03 15:49:44"/> <offer id="5045071" ot="win" price="26" recdate="2015-08-03 15:50:58"/> Example full document This is a simple example of a whole XML document returned <races time="2015-08-03 23:53:45" timestamp="1438617225"> <race mid="50238" tipex-matchid="54292" xsid="0" lastupdate="2015-08-03 10:57:16" Live="0"> <time>2015-08-03t15:55:00</time> <group id="20502">hrukinaas</group> <bookmaker name="bet365" Place="1/4" Rank="3"> <horse id="206870" horse="pretty Famous"> <offer id="5044793" ot="win" price="13" recdate="2015-08-03 15:49:43"/> <horse id="208949" horse="staccato Wolf"> <offer id="5044805" ot="win" price="17" recdate="2015-08-03 15:49:44"/> <horse id="211308" horse="taggsisland"> <offer id="5044787" ot="win" price="6.5" recdate="2015-08-03 15:49:43"/> <offer id="5045089" ot="win" price="6" recdate="2015-08-03 15:51:09"/> <offer id="5045259" ot="win" price="5.5" recdate="2015-08-03 15:52:36"/> <horse id="211315" horse="baunaniska"> <offer id="5044795" ot="win" price="21" recdate="2015-08-03 15:49:44"/> <offer id="5045071" ot="win" price="26" recdate="2015-08-03 15:50:58"/> Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 13 of 25
<horse id="214230" horse="the Fairy"> <offer id="5044790" ot="win" price="8" recdate="2015-08-03 15:49:43"/> <horse id="214487" horse="standinthesunlight"> <offer id="5044802" ot="win" price="26" recdate="2015-08-03 15:49:44"/> <horse id="216371" horse="william Ashford"> <offer id="5044804" ot="win" price="26" recdate="2015-08-03 15:49:44"/> <horse id="217890" horse="double Fast"> <offer id="5044799" ot="win" price="11" recdate="2015-08-03 15:49:44"/> <horse id="217913" horse="beechmount Whisper"> <offer id="5044657" ot="win" price="3" recdate="2015-08-03 15:48:53"/> <offer id="5044792" ot="win" price="3.25" recdate="2015-08-03 15:49:43"/> <offer id="5044852" ot="win" price="3" recdate="2015-08-03 15:49:59"/> <offer id="5044925" ot="win" price="2.87" recdate="2015-08-03 15:50:24"/> <offer id="5045138" ot="win" price="3" recdate="2015-08-03 15:51:33"/> <horse id="219088" horse="mixin N Scratchin"> <offer id="5044801" ot="win" price="26" recdate="2015-08-03 15:49:44"/> <horse id="234035" horse="in The Dark"> <offer id="5045024" ot="win" price="21" recdate="2015-08-03 15:50:47"/> <horse id="261759" horse="volt"> <offer id="5044970" ot="win" price="17" recdate="2015-08-03 15:50:37"/> <horse id="263772" horse="benjalina"> <offer id="5044789" ot="win" price="9" recdate="2015-08-03 15:49:43"/> <offer id="5044937" ot="win" price="8.5" recdate="2015-08-03 15:50:27"/> <offer id="5045079" ot="win" price="9" recdate="2015-08-03 15:51:03"/> <offer id="5045235" ot="win" price="10" recdate="2015-08-03 15:52:22"/> <horse id="267517" horse="athloman Cottage"> <offer id="5044798" ot="win" price="13" recdate="2015-08-03 15:49:44"/> <offer id="5045072" ot="win" price="11" recdate="2015-08-03 15:50:58"/> <offer id="5045113" ot="win" price="9" recdate="2015-08-03 15:51:24"/> <offer id="5045196" ot="win" price="8" recdate="2015-08-03 15:52:07"/> <horse id="541321" horse="brutally Honest"> <offer id="5044796" ot="win" price="26" recdate="2015-08-03 15:49:44"/> </bookmaker> </race> </races> Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 14 of 25
Appendix 1 Bookmakers The following bookmakers are usually available in the feed at the time of writing this document Bet365 BetFred Betstar BookMaker BoyleSports Centrebet Coral Ladbrokes Ladbrokes.au PaddyPower Skybet Sportingbet Sportsbet SportsTAB StanJames Tattsbet Tom Waterhouse Tote Betvictor William Hill PLEASE NOTE: Not all bookmakers will cover each race. If you cannot see one of the above bookmakers please contact our support engineers at tipex_ahc_services@hotmail.com Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 15 of 25
Appendix 2 Courses (Groups) webservice The master groups provide a link to the TXODDS Master Feed where you can see the race courses available in the feed. PLEASE NOTE: This is a new webservice for the 2015/16 season. http://ahceur2.txodds.com/oddsdata/db/groups.jsp&spid=76&sid=13,15 <groups> <id>12284</id> <mgroup id="1902">hruki <name>aintree</name> <sid>13</sid> <fullname>hruki Aintree-13</fullname> <date1>2013-01-01 00:00:00</date1> <date2>2013-12-31 00:00:00</date2> </group> <id>12285</id> <mgroup id="1902">hruki <name>bangor-on-dee</name> <sid>13</sid> <fullname>hruki Bangor-on-Dee-13</fullname> <date1>2013-01-01 00:00:00</date1> <date2>2013-12-31 00:00:00</date2> </group> <id>12286</id> <mgroup id="1902">hruki <name>cartmel</name> <sid>13</sid> <fullname>hruki Cartmel-13</fullname> <date1>2013-01-01 00:00:00</date1> <date2>2013-12-31 00:00:00</date2> </group> ELEMENTS group ATTRIBUTE id The unique ID code of the group mgroup Attribute id Master Group id code Master group name is shown in this element name The race course name Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 16 of 25
sid The starting year of the season/event Note: Currently for horse racing UK & Ireland courses have sid=13 and Non-UK have sid=15. fullname date1 A concatenation of the mgroup name and the group name The approximate start date of the event Note: Currently for horse racing UK & Ireland courses have sid=13 and Non-UK have sid=15. date2 The approximate end date of the event Note: Currently for horse racing UK & Ireland courses have sid=13 and Non-UK have sid=15. Filtering The webservice can currently be filtered by:- Master Group ID For example, you can request the mgid=2155 to provide all HRZAF ( South African) courses http://ahceur2.txodds.com/oddsdata/db/groups.jsp?userid=xxx&passid=yyy&mgid=2155 <groups> <id>22466</id> <mgroup id="2155">hrzaf <name>turffontein</name> <sid>15</sid> <fullname>hrzaf Turffontein-15</fullname> <date1>2015-01-01 00:00:00</date1> <date2>2015-12-31 00:00:00</date2> </group> <id>22467</id> <mgroup id="2155">hrzaf <name>scottsville</name> <sid>15</sid> <fullname>hrzaf Scottsville-15</fullname> <date1>2015-01-01 00:00:00</date1> <date2>2015-12-31 00:00:00</date2> </group> <id>22493</id> <mgroup id="2155">hrzaf <name>fairview</name> <sid>15</sid> <fullname>hrzaf Fairview-15</fullname> <date1>2015-01-01 00:00:00</date1> <date2>2015-12-31 00:00:00</date2> </group> <id>22512</id> <mgroup id="2155">hrzaf <name>vaal</name> <sid>15</sid> <fullname>hrzaf Vaal-15</fullname> <date1>2015-01-01 00:00:00</date1> <date2>2015-12-31 00:00:00</date2> Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 17 of 25
</group>.. etc.. </groups> Year/Season ID PLEASE NOTE: Currently for horse racing UK & Ireland courses have sid=13 and Non-UK & Ireland have sid=15. http://ahceur2.txodds.com/oddsdata/db/groups.jsp?userid=xxx&passid=yyy&mgid=1092&sid=1 3,15 <groups> <id>12284</id> <mgroup id="1902">hruki <name>aintree</name> <sid>13</sid> <fullname>hruki Aintree-13</fullname> <date1>2013-01-01 00:00:00</date1> <date2>2013-12-31 00:00:00</date2> </group> <id>12285</id> <mgroup id="1902">hruki <name>bangor-on-dee</name> <sid>13</sid> <fullname>hruki Bangor-on-Dee-13</fullname> <date1>2013-01-01 00:00:00</date1> <date2>2013-12-31 00:00:00</date2> </group> <id>12286</id> <mgroup id="1902">hruki <name>cartmel</name> <sid>13</sid> <fullname>hruki Cartmel-13</fullname> <date1>2013-01-01 00:00:00</date1> <date2>2013-12-31 00:00:00</date2> </group> League ID/Pgid For example, you can request the webservice for any know course id to return further data To get the details for Cartmel you could request http://ahceur2.txodds.com/oddsdata/db/groups.jsp?userid=xxx&passid=yyy&pgid=12286 <groups> <id>12284</id> <mgroup id="1902">hruki <name>aintree</name> <sid>13</sid> <fullname>hruki Aintree-13</fullname> <date1>2013-01-01 00:00:00</date1> <date2>2013-12-31 00:00:00</date2> </group> Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 18 of 25
<groups> <id>12286</id> <mgroup id="1902">hruki <name>cartmel</name> <sid>13</sid> <fullname>hruki Cartmel-13</fullname> <date1>2013-01-01 00:00:00</date1> <date2>2013-12-31 00:00:00</date2> </group> </groups> Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 19 of 25
Appendix 3 Master Groups webservice The master groups provide a link to the TXODDS Master Feed where you can see all the available country & course static data mappings using the Horse Racing sport id code (&spid=76) PLEASE NOTE: This is a new webservice for the 2015/16 season. http://ahceur2.txodds.com/oddsdata/db/mgroups.jsp&spid=76 <mgroups> <id>1902</id> <name>hruki</name> <countryid>652</countryid> <id>2154</id> <name>hrchi</name> <countryid>399</countryid> <id>2155</id> <name>hrzaf</name> <countryid>447</countryid> <id>2156</id> <name>hrarg</name> <countryid>467</countryid> <id>2157</id> <name>hruae</name> <countryid>461</countryid> <id>2158</id> <name>hrusa</name> <countryid>459</countryid> <id>2159</id> <name>hrsgp</name> <countryid>404</countryid> <id>2161</id> <name>hrfra</name> <countryid>408</countryid> <id>2164</id> <name>hruru</name> <countryid>402</countryid> Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 20 of 25
<id>2166</id> <name>hraus</name> <countryid>454</countryid> <id>2167</id> <name>hrbel</name> <countryid>377</countryid> <id>2168</id> <name>hrjpn</name> <countryid>416</countryid> <id>2170</id> <name>hrqat</name> <countryid>369</countryid> <id>2171</id> <name>hrnzl</name> <countryid>488</countryid> <id>2172</id> <name>hrhkg</name> <countryid>479</countryid> <id>2173</id> <name>hrger</name> <countryid>446</countryid> <id>2180</id> <name>hrcan</name> <countryid>385</countryid> <id>2183</id> <name>hrswe</name> <countryid>410</countryid> <id>2184</id> <name>hrita</name> <countryid>398</countryid> <id>2192</id> <name>hrnor</name> <countryid>431</countryid> </mgroups> ELEMENTS mgroup ATTRIBUTE Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 21 of 25
id The unique ID code of the master group name Master group name i.e. HKUKI is the master group name for Horse Racing (FB) in England & Ireland ( UKI) sportid Sport id code. This will be 76 for Horse Racing Note: Please see Appendix 4 Sports webservice countryid Country ID code Note: Please see Appendix 5 - Countries webservice Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 22 of 25
Appendix 4 Sports webservice The sports id provide static data/id codes for each sport PLEASE NOTE: This is a new webservice for the 2015/16 season. http://ahceur2.txodds.com/oddsdata/db/sports.jsp <sports> <sport> <id>1</id> <name>soccer</name> </sport> <sport> <id>2</id> <name>ice hockey</name> </sport> <sport> <id>3</id> <name>basketball</name> </sport> <sport> <id>4</id> <name>rugby union</name> </sport> <sport> <id>5</id> <name>tennis</name> </sport> <sport> <id>6</id> <name>us football</name> </sport> <sport> <id>7</id> <name>baseball</name> </sport> <sport> <id>8</id> <name>handball</name> </sport> etc. ELEMENTS sport ATTRIBUTE id The unique ID code of the sport name Sport name Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 23 of 25
Appendix 5 - Countries webservice All current country names and ids can be found via this webservice. PLEASE NOTE: This is a new webservice for the 2015/16 season. http://ahceur2.txodds.com/oddsdata/db/countries.jsp <countries> <country> <id>361</id> <cc>iri</cc> <name>iran</name> </country> <country> <id>362</id> <cc>nhl</cc> <name>nhl</name> </country> <country> <id>363</id> <cc>bul</cc> <name>bulgaria</name> </country> <country> <id>364</id> <cc>ven</cc> <name>venezuela</name> </country>..etc ELEMENTS country ATTRIBUTE id The unique ID code of the country name Country name cc Country short name/abbreviation. Note: Wherever possible this is the same country abbreviation as used in the ISO 3166 codes https://en.wikipedia.org/wiki/iso_3166-1_alpha-3 PLEASE NOTE: For historical data reasons some sports such as NHL, NCAA, NBA are listed as countries. Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 24 of 25
Document History Changes This section is intended to give a quick overview over the most important and / or obvious changes to the feed formatting and features for each release of this User guide document. Version 3.00 New Features Initial document creation Version 3.01 New Features Revised URL formats Version 4.01 New Features Updated to reflect coverage of worldwide racing instead of just UK/Ireland as previously Added the following new webservices Appendix 2 Courses (Groups) webservice Appendix 3 Master Groups webservice Appendix 4 Sports webservice Appendix 5 - Countries webservice Version 4.02 New Features Changed customer support email to ahc@txodds.com and added Skype support account ahcasiaservices Copyright TXODDS Sport Betting Limited 2015. All rights reserved. Page 25 of 25