Version 3.0.3 API6
WARNING THIS VERSION OF BBDEMO IS TRANSACTIONAL. IT WILL PLACE BETS
Before downloading BBDemo you must Login to Chromaweb.
If you are not Registered with Chromaweb you can Register
here.
Because BBDemo uses the Free Betfair API we do not need your Betfair Username
for BBDemo.
Once Logged in to Chromaweb, you can download BBDemo here.
BBDemo Contents:
|
|
Introduction
BBDemo allows Users to schedule Back or Lay Bets to be submitted
on Named runners, or on UnNamed Favorites, 2nd Favs or 3rd Favs at
specified times (in relation to the scheduled OffTimes) on any Betfair
Horse Racing markets
BBDemo a very basic Bet Scheduling application, intended mainly as a
Demonstration of how our BotBuilder framework incorporates Triggers
and Scheduling that can be adapted and combined in different ways to
produce Custom Bots to implement much more sophisticated Betting strategies.
BBDemo schedules can be set up at any time (on the day of the Races,
or, if today's last race is finished, tomorrow's Races) before the scheduled
Race OffTimes and then left unattended to submit your bets throughout
the day.
... and BBDemo is Free!
Once installed you should see a shortcut icon on your desktop: 
Click the shortcut to start BBDemo. |
Set Defaults
As warned above, this version of BBDemo is Transactional, so, unless you tick
'Test Mode' on the Defaults Tab, it will submit Bets.
We strongly advise that, if this is your first time using BBDemo, you run
it for a while in Test Mode, just to check that you understand how it goes
about implementing your Triggers and Scheduling.
The Defaults tab opens automatically after you have Logged In to BBDemo.
You LogIn to BBDemo using your Betfair Username and Password.
Like all of our Bots, BBDemo Logs In to the Betfair API via https, the secure
Internet Protocol.
BBDemo communicates directly with the Betfair API, and never to any Third
Party (including Chromaweb), so your LogIn and other transactions with Betfair
are as secure as those that you normally make via the Betfair website.
With BBDemo you can now choose whether to display all of Betfair's Horse
Racing markets or just UK and Irish Racing.
You can choose which to Display via the radio buttons on the LogIn panel:
If you select 'UK and Irish Horse Races', then the after Logging In, a
Defaults Tab like this will be opened:
If you have chosen 'All Horse Races' your Defaults Tab will look like this:
If you intend to bet on Australian Horse Races, don't forget to make sure
you have some funds in your Betfair Australian Wallet (you can transfer
funds between wallets via the Betfair website).
If you have changed your Menu Mode, and you want BBDemo to open in this
mode in future, click 'Save Defaults', even if you haven't made any other
changes ... you can always change the Menu Mode on the Login Panel the next
time you LogIn, should your wish.
The main features of BBDemo, which you can select on the Defaults Tab are:
-
Whether you want to Back or Lay Runners
-
Whether your Bets are to be made on the UnNamed
Favorite, 2nd Favorite or 3rd Favorite, or on Named (Runner(s)).
-
Whether your Bets are to be Submitted at a specified
number of minutes before the Scheduled OffTime of your selected races,
or immediately after your Races go 'InPlay'
You can set all of these, and other, relatively minor options on the Defaults
Tab, so that they will be saved and become the Defaults every time you start
a new BBDemo session.
They are also the Defaults that will show on the Selected Races Tabs when
you are selecting which Races you want to Bet on, but you can adjust any of
them for the Races on Selected Race Tabs.
Most of these settings are explained in the illustration above, but, additionally:
Stake is the Stake per Bet.
Bet MaxLiability is the maximum liability that BBDemo
will incur on any single bet ... this is important when you are Laying at
high Prices, for example if your Stake is £20 and you Lay a Runner
priced at 7, then your potential liability, should the Runner win would
be £120 ... if this is too much for you to comfortably risk, then
setting Bet MaxLiability at e.g.£100 would make BBDemo reduce your
Stake to £16.66 thus keeping your Liability under £100.
BBDemo always reduces your Stake if it would exceed your Bet MaxLiability
... if this reduces your Stake to less than £2.00 (the minimum Betfair Stake)
then no bet will be placed and "Stake < £2" will be shown in
the appropriate column of the Market Display table.
Session MaxLiability whenever BBDemo starts to monitor a
new race it totals up the Profit / Loss for all settled bets during the current
session. If BBDemo has lost more than your Session MaxLiability, then it will
stop running and stop placing bets.
Please note that sometimes there are delays in Settling bets, for example
if there is a Stewards Enquiry, or if racing is delayed for some reason, so
BBDemo cannot guarantee to know your precise session Profit / Loss all of
the time, so, when setting Session MaxLiability, you should err on the side
of caution. 
Select Meetings / Races
1) In UK and Irish Horse Races Mode:
Once you are satisfied with your Default settings, click on 'Select Races'
and a Menu of all of Today's UK and Irish Racing will be opened on a new Tab:
you can select any Races you like from this Menu ... either individual Races
at different meetings, or all of the Races at one meeting, or a combination
of both.
You can also adjust any of the Default settings to new Settings that will
apply only to the Races to be monitored on this Tab.
Once you have selected your Races and (optionally) adjusted your Settings,
press 'Set Triggers'.
2) In 'All Horse Races' Mode:
Click on the 'Horse Racing' menu and it will expand to show all of the Horse Race Meetings currently available
on Betfair:
Click on a Race Meeting to open a new Tab for that Meeting:
you can select all of the Races at this meeting or select individual Races.
You can also adjust any of the Default settings to new Settings that will
apply only to the Races to be monitored on this Tab.
Both Menu Modes:
Once you have selected your Races and (optionally) adjusted your Settings,
press 'Set Triggers':
If you have set your Defaults to Bet on an UnNamed Favorite, 2nd Fav or 3rd
Fav the next screen will look like this:
the races you have selected are sorted into chronological order and the number
of seconds until BBDemo will start monitoring them is displayed.
In the Header for each Race there is a button: 'Race Triggers +'.
:
Race Triggers: Clicking on 'Race Triggers +' will open
a small new Panel that allows you to Adjust and Save the most important
Default Triggers for the selected race.
If you have chosen to bet on the Fav, 2nd Fav or 3rd Fav (as opposed to
Select Runners), then clicking 'Race Triggers' will also open a display
of the Race Runners so that you can exclude any Runners from betting on
this Race if you wish:
If you chose 'Select Runners', then the Runners are displayed by Default,
but clicking 'Race Triggers' will allow you to adjust the Triggers for this
Race:
As you make changes you should see them displayed under 'Bets to be submitted
...'
The same Triggers will apply to all qualifying runners in the race i.e.
you cannot have different Triggers for different runners in the same display,
but if you do want, for example, different stakes for different runners
then you can simply open the same race in two or more different Tabs.
Once you have made any changes you require to the Triggers then, to make
more space for the display of your Bets / Results, you can close the 'Adjust
Triggers' panel by clicking the 'Race Triggers -' button.
If you simply want to apply the Default Triggers to your selected Races,
then you don't need to open 'Race Triggers' at all.
Start Time: This
is the Time when BBDemo will check the Betfair Market to see if the current
price of the Fav, 2nd Fav, 3rd Fav, or your Selected Runners is within your
Triggers, and, if it is, submit your Bets.
If you chose 'InPlay' as the Start Time, BBDemo will start monitoring the
Races 30 seconds before their Scheduled OffTimes, but will wait until the
first Market Update after InPlay before placing its Bets if there are any
qualifying Runners.
If you choose 'InPlay' as the Start Time for a Race that won't be going InPlay,
e.g. USA or Australian races, then BBDemo will check the market and place
any Bets 10 seconds before the scheduled Offtime (since, fairly obviously
BBDemo can't predict in advance what time the Race will actually start). Also,
in these circumstances, as soon as BBDemo has placed your Bet, it will stop
updating that market
If you chose any other value for the Start Time then BBDemo will start monitoring
the Race at the selected number of seconds or minutes before the scheduled
OffTime and submit its Bets at that time, if there are any qualifying Runners.
In the image below we have chosen 'InPlay' for the Start Time, and we have
chosen to Back the Favorite in the Win and Place Markets if its price is
between1.8 and 6.0 at InPlay.
The current time is now within 30 seconds of the scheduled Offtime so BBDemo
has started to monitor the Race and is displaying the Runners and updating
their prices approx once-per-second.
Because BBDemo has started monitoring the Race, it's now too late to change
the Triggers for this Race, so the 'Race Triggers +' button has been removed
from the Header.
If your Start Time is InPlay then, when the Race tirns InPlay if the Selected
Runner's Market price is within your Triggers the Bet is Submitted:
Bets Settled:
If the Favorite (or 2nd Fav or 3rd Fav) at the first Market Update after
InPlay is different from the Fav at the Last Market Update before InPlay,
BBDemo submits its Bet on the Runner that was Fav (or 2nd etc) at the Last
Market Update before InPlay:
Because BBDemo uses the Free Betfair API, it is important to reduce the number
of calls it makes to the absolute minimum, so BBDemo now stops monitoring
this race, so, if you are in Test mode there is no further update to the Display.
In Transactional mode more details of your Bet will be displayed, and you
can check on the outcome of your bets by Clicking the 'Check Bet Results'
button to update your Settled bets.
If the price of the qualifying Favorite fell outside of your Min Price /
Max Price parameters then no Bet is placed and the display will look like
this:
Multiple Tabs:
If you are in 'All Horse Races' menumode, then each different Meeting that
you select is opened on a separate Tab:
You open a new Meetings Tab by clicking on the 'Defaults' Tab and selecting
a Meeting from the Menu... this gives you the opportunity to adjust the Default
Settings again if required.
You can open any Meeting on more than one Tab if you wish, so that, for example
you can place Back Bets on some races and Lay Bets on other (or the same)
Races at the same Meeting.
If you are in 'UK and Irish Horse Races' menumode then you open a new Tab
by clicking on the 'Defaults' Tab and a new Tab will open from which you can
select any UK / Irish Races, and, again, you can have the same Races running
on different Tabs if you wish to apply different Triggers to the same Races.
Exclude Runners
Most of us have certain horses that we wouldn't Back even if they were
1.01 in a 3 Runner race, or Lay at any Price, so, as noted above, when you
are Backing or Laying the UnNamed favorite (or 2nd or 3rd fav), you can
Exclude runners from your Bets via the display opened by clicking 'Race
Triggers +':
You can Select / Deselect (by clicking on their names) runner(s) that you
do not wish to Back or Lay, even if they match your other Triggers:
NB To save on calls to the Free API, BBDemo does not start to Update the
race markets again until the Race reaches its 'Mins before Offtime'.
Also the 'Race Triggers' Button is available only until your 'Mins before
Offtime' (or 30 seconds before OffTime if you have chosen 'InPlay').
If you you've made and saved any changes you want to the Triggers, or you
don't want to change them, then you can make more space for the display
of your Bets / Results by clicking on 'Race Triggers -" to close the
'Adjust Triggers' panel.
Place Betting
You can choose to Submit bets into the Win Market, or the Place Market, or
Both.
In all cases, where bets are to be submitted into the Place Market, they
are Triggered on the basis of the Win Market Price, i.e. if selected, a Place
Bet will be submitted on a Runner at its current Best Place Market Back or
Lay Price when that Runner meets all qualifying conditions for a corresponding
Win Back or Lay Bet.
You must choose to Submit either Win Bets or Place Bets or both before BBDemo
can proceed on to monitoring your selected Races.
As a safeguard against Place Back bets being submitted at a very low price,
and, more importantly, Place Lay Bets being submitted at very high prices
you should also select and save a Min Place BackPrice and a Max Place Lay
Price appropriate to your other settings.
It is very important that you set a sensible Max Place
Lay Price ... remember that the Bets are submitted on the basis of the Win
Market, so, even if the Lay Price in the Win Market is, say 5.0, the Lay Price
in the Place Market could be, at least in theory, anything up to 1000 ...
if you haven't set the Max Place Lay Price BBDemo could submit a Lay Offer
at 1000 ... in practice your Bet Max Liability would probably prevent this,
but it is much more sensible to set Max Place Lay Price to a safe value.
As with other Triggers you can set whether to Submit Place (and or Win) Bets
on the Defaults Tab, and you can adjust this setting on individual Race Tabs:
Selecting Named Runners:
If you prefer to to Back / Lay specific Runners, rather than the UnNamed
Fav, 2nd Fav or 3rd Fav, then click the 'Select Runner' Option.
When you hit 'Select Races' with the 'Select Runner' option then, instead
of waiting until the 'Mins Before Offtime', BBDemo shows the Runners and
their Current Market Prices for each selected Race (almost*) immediately.
(*Please note that, because BBDemo uses the Free API, which limits the number
of Calls per Minute, BBDemo has a built in 10 second delay between opening
the Markets on this Tab ... just about long enough for you to select your
Runner!).
You select / deselect your Runner(s) by Clicking on their name(s) and you
can change your Selections at any time up to your Start Time (mins before
Offtime or InPlay time), and, as outlined above, you an adjust the Default
Trigger settings via clicking 'Race Triggers + '.
NB To save on calls to the Free API, BBDemo does not start to Update the
race markets again until the Race reaches its 'Mins before Offtime'.
Bets Placed and Results
