NAME

WWW::BetfairNG - Object-oriented Perl interface to the Betfair JSON API

VERSION

Version 0.15

SYNOPSIS

use WWW::BetfairNG;

my $bf = WWW::BetfairNG->new();
$bf->ssl_cert(<path to ssl cert file>);
$bf->ssl_key(<path to ssl key file>);
$bf->app_key(<application key>);

$bf->login({username => <username>, password => <password>});
...
$bf->keepAlive();
...
$bf->logout();

DESCRIPTION

Betfair is an online betting exchange which allows registered users to interact with it using a JSON-based API. This module provides an interface to that service which handles the JSON exchange, taking and returning perl data structures (usually hashrefs). Although there is an option to thoroughly check parameters before sending a request, and a listing of the BETFAIR DATA TYPES is provided below, it requires a level of understanding of the Betfair API which is best gained from their own documentation, available from https://developer.betfair.com/

To use this library, you will need a funded Betfair account and an application key. To use the non-interactive log in, you will also need an SSL certificate and key (in seperate files, rather than a single .pem file). Details of how to create or obtain these, and how to register your certificate with Betfair are also available on the above website. The interactive login does not require an SSL certificate or key and is therefore easier to set up, but Betfair strongly recommend that unattended bots use the non-interactive version.

METHODS

Construction and Setup

new([$parameters])

my $bf = new WWW::BetfairNG;          OR
my $bf = WWW::BetfairNG->new();       OR
my $bf = WWW::BetfairNG->new({
                              ssl_cert => '<path to ssl certificate file>',
                              ssl_key  => '<path to ssl key file>',
                              app_key  => '<application key value>',
                             });

Creates a new instance of the WWW::BetfairNG class. Takes an optional hash or hash reference of configurable attributes to set the application key and/or paths to ssl cert and key files. (These may also be set after instantiation via the accessors described below, but in any case the ssl cert and key need to be present for a successful non-interactive login). The application key is required for most of the API calls, but not for login/logout or 'getDeveloperAppKeys', so if necessary the key can be retrieved from Betfair and then passed to the object using $bf->app_key. If logging in is not possible for some reason, but an active session token can be obtained by other means, this may also be passed to the new object using {session => <session token value>}; the object will then behave as if it were logged in.

Accessors

ssl_cert([<path to ssl cert file>])

my $cert_file = $bf->ssl_cert();
$bf->ssl_cert('<path to ssl certificate file>');

Gets or sets the path to the file containing the client certificate required for non-interactive login. Default is '', so this needs to be set for a sucessful login. See Betfair documentation for details on how to create and register client SSL certificates and keys.

ssl_key([<path to ssl key file>])

my $key_file = $bf->ssl_key();
$bf->ssl_key('<path to ssl key file>');

Gets or sets the path to the file containing the client key required for non-interactive login. Default is '', so this needs to be set for a sucessful login. See Betfair documentation for details on how to create and register client SSL certificates and keys.

app_key([<key value>])

my $app_key = $bf->app_key();
$bf->app_key('<application key value>');

Gets or sets the application key required for most communications with the API. This key is not required to log in or to use 'getDeveloperAppKeys', so it may be retrieved from Betfair and then passed to the object using this accessor. It may also be possible to create the app keys using 'createDeveloperAppKeys', but as this call fails if keys already exist, it was not possible to test this. See Betfair documentation for how to obtain Application Keys using their API-NG Visualiser.

session()

my $session_token = $bf->session();
$bf->session('<session token value>');

Gets or sets the current Session Token. Contains '' if logged out. Normally this is set automatically at login and after keepAlive, and unset at logout, but it can be set by hand if necessary.

check_parameters()

my $check = $bf->check_parameters();
$bf->check_parameters('<boolean>');

Gets or sets a flag telling the object whether or not it should do a detailed check on the validity of parameters passed to the API methods. If this is set, the parameter hash will be checked before it is sent to the API, and any errors in construction will result in the method call immediately returning '0' and $bf->error being set to a message detailing the precise problem. Only the first error found will be returned, so several iterations may be necessary to fix a badly broken parameter hash. If the flag is not set, any parameters that are a valid hashref or anonymous hash will be passed straight to Betfair, and errors in the construction will result in a Betfair error, which will usually be more general (i.e. cryptic and unhelpful). As some parameter hashes can be quite complicated, there is a performance hit incurred by turning parameter checking on. For this reason, the default is to NOT check parameters, although you should turn it on during development and for debugging.

australian() DEPRECATED

my $is_aus = $bf->australian();
$bf->australian('<boolean>');

Betfair previously used seperate URLs for Australian racing, and this method implemented the switching between those URLs. From 2016-09-20 the Australian exchange was integrated into the main exchange, making this method unnecessary. From 2017-01-04 calls to the Australian endpoints WILL NO LONGER WORK.

The method has been retained in this version for backwards compatibility, but no longer changes the endpoints. It exists purely to avoid breaking existing third party code. If your application uses this method, you are STRONGLY RECOMMENDED to remove any references to it, as it will be removed in future versions.

error()

my $err_str = $bf->error();

Read-only string containing the last error encountered. This is not reset by sucessful calls, so the return value of the method needs to be checked to determine success or failure (all methods return '0' if any error is encountered):

unless ($ret_value = $bf->someCall($parameters) {
  $err_str = $bf->error();
  print "someCall FAILED : $err_str\n";
  <error handling code>
}

Errors at any stage will populate this string, including connection timeouts and HTTP errors. If the call makes it as far as the Betfair API before failing (for instance, a lack of available funds), the decoded JSON response will be available in $bf->response and may well contain more detailed and descriptive error messages, so this is probably the best place to look if the high level Betfair error string returned in $bf->error() is vague or ambiguous. (This is especially useful in cases where a number of bets are submitted for processing, and one of them fails - this usually makes the whole call fail, and the only way to find the culprit is to dig through the response and find the bet which caused the problem).

response()

my $resp = $bf->response();

Read-only hash ref containing the last successful response from the API (for certain values of 'successful'). If an API call succeeds completely, it will return a hash reference containing the decoded JSON response (which will be identical to $bf->response), so in this case, $bf->response() is pretty much redundant. If ANY error is encountered, the return value from the API call will be '0', and in this case more details on the specific error can often be found by examining $bf->response(). (Obviously this only works for calls which fail after reaching the API; an HTTP 404 error, for example, will leave the response from the previous successful API call in $bf->response).

API CALLS

These are generally of the form '$return_value = $bf->someCall($parameters)', where '$parameters' is a hash reference (or anonymous hash) containing one or more BETFAIR DATA TYPES (described below), and $return_value is a hash or array reference, again containing one or more BETFAIR DATA TYPES. Many of these data types are straightforward lists or hashes of scalars, but some are quite complex structures. Depending on the call, some parameters may be required (RQD) and others may be optional (OPT). If $bf->check_parameters() is set to 'true', the parameter hash will be checked before it is sent to the API, and any errors in construction will result in the method call immediately returning '0' and $bf->error being set to a message detailing the precise problem. If $bf->check_parameters() is set to 'false' (the default), the parameter hash is sent 'as is' to Betfair, and any problems with it's construction will result in a Betfair error message. Any error in a call, for whatever reason, will result in a $return_value of '0'. In this case, $bf->error() will contain a string describing the error and further details of the error may be found by examining $bf->response().

Session Methods

my $return_value = $bf->login({username => 'username', password => 'password'});

Logs in to the application using the supplied username and password. For a successful login, 'ssl_cert' and 'ssl_key' must already be set. Returns '1' if the login succeeded, '0' if any errors were encountered.

interactiveLogin({username => 'username', password => 'password'})

my $return_value = $bf->interactiveLogin({username => 'username',
                                          password => 'password'});

Logs in to the application using the supplied username and password. This method doesn't use SSL certificates, so it will work without setting those up. However, Betfair STRONGLY RECOMMEND that unattended bots use the non-interactive login ($bf->login()). Returns '1' if the login succeeded, '0' if any errors were encountered.

logout()

my $return_value = $bf->logout();

Logs out of the application. Returns '1' if the logout succeeded,'0' if any errors were encountered.

keepAlive()

my $return_value = $bf->keepAlive();

Sends a 'Keep Alive' message to the host. Without this, the session will time out after about four hours. Unlike the SOAP interface, other API calls do NOT reset the timeout; it has to be done explicitly with a 'keepAlive'. Returns '1' if the keepAlive succeeded, '0' if any errors were encountered.

Betting Operations

The descriptions of these methods are taken directly from the Betfair documentation. A listing is given of parameters which can be passed to each method together with their data type (BETFAIR DATA TYPES are described below). Required parameters are marked as RQD and optional ones as OPT. If a parameter is marked as RQD, you need to pass it even if it contains no data, so a MarketFilter which selects all markets would be passed as:

filter => {}

listCompetitions($parameters)

my $return_value = $bf->listCompetitions({filter => {}});

Returns a list of Competitions (i.e., World Cup 2013) associated with the markets selected by the MarketFilter. Currently only Football markets have an associated competition.

Parameters

filter            MarketFilter        RQD
locale            String (ISO 3166)   OPT

Return Value

Array Ref         CompetitionResult

listCountries($parameters)

my $return_value = $bf->listCountries({filter => {}});

Returns a list of Countries associated with the markets selected by the MarketFilter.

Parameters

filter            MarketFilter        RQD
locale            String (ISO 3166)   OPT

Return Value

Array Ref         CountryCodeResult

listCurrentOrders([$parameters])

my $return_value = $bf->listCurrentOrders();

Returns a list of your current orders. Optionally you can filter and sort your current orders using the various parameters, setting none of the parameters will return all of your current orders, up to a maximum of 1000 bets, ordered BY_BET and sorted EARLIEST_TO_LATEST. To retrieve more than 1000 orders, you need to make use of the fromRecord and recordCount parameters.

Parameters

betIds               Array of Strings    OPT
marketIds            Array of Strings    OPT
orderProjection      OrderProjection     OPT
customerOrderRefs    Array of Strings    OPT
customerStrategyRefs Array of Strings    OPT
dateRange            TimeRange           OPT
orderBy              OrderBy             OPT
sortDir              SortDir             OPT
fromRecord           Integer             OPT
recordCount          Integer             OPT

Return Value

currentOrders     Array of CurrentOrderSummary
moreAvailable     Boolean

listClearedOrders([$parameters])

my $return_value = $bf->listClearedOrders({betStatus => 'SETTLED'});

Returns a list of settled bets based on the bet status, ordered by settled date. To retrieve more than 1000 records, you need to make use of the fromRecord and recordCount parameters. (NOTE The default ordering is DESCENDING settled date, so most recently settled is listed first).

Parameters

betStatus            	 BetStatus           RQD
eventTypeIds         	 Array of Strings    OPT
eventIds             	 Array of Strings    OPT
marketIds            	 Array of Strings    OPT
runnerIds            	 Array of Strings    OPT
betIds               	 Array of Strings    OPT
customerOrderRefs    	 Array of Strings    OPT
customerStrategyRefs 	 Array of Strings    OPT
side                 	 Side                OPT
settledDateRange     	 TimeRange           OPT
groupBy              	 GroupBy             OPT
includeItemDescription Boolean             OPT
locale               	 String              OPT
fromRecord           	 Integer             OPT
recordCount          	 Integer             OPT

Return Value

clearedOrders     Array of ClearedOrderSummary
moreAvailable     Boolean

listEvents($parameters)

my $return_value = $bf->listEvents({filter => {}});

Returns a list of Events associated with the markets selected by the MarketFilter.

Parameters

filter            MarketFilter        RQD
locale            String (ISO 3166)   OPT

Return Value

Array Ref         EventResult

listEventTypes($parameters)

my $return_value = $bf->listEventTypes({filter => {}});

Returns a list of Event Types (i.e. Sports) associated with the markets selected by the MarketFilter.

Parameters

filter            MarketFilter        RQD
locale            String (ISO 3166)   OPT

Return Value

Array Ref         EventTypeResult

listMarketBook($parameters)

my $return_value = $bf->listMarketBook({marketIds => [<market id>]});

Returns a list of dynamic data about markets. Dynamic data includes prices, the status of the market, the status of selections, the traded volume, and the status of any orders you have placed in the market. Calls to listMarketBook should be made up to a maximum of 5 times per second to a single marketId.

Parameters

marketIds                     Array of Strings    RQD
priceProjection               PriceProjection     OPT
orderProjection               OrderProjection     OPT
matchProjection               MatchProjection     OPT
includeOverallPosition        Boolean             OPT
partitionMatchedByStrategyRef Boolean             OPT
customerStrategyRefs          Array of Strings    OPT
currencyCode                  String              OPT
locale                        String              OPT

Return Value

Array Ref                     MarketBook

listRunnerBook($parameters)

my $return_value = $bf->listRunnerBook({marketId    => <market id>,
                                        selectionId => <selection id>});

Returns a list of dynamic data about a market and a specified runner. Dynamic data includes prices, the status of the market, the status of selections, the traded volume, and the status of any orders you have placed in the market. You can only pass in one marketId and one selectionId in that market per request. If the selectionId being passed in is not a valid one / doesn't belong in that market then the call will still work but only the market data is returned.

Parameters

marketId                      String              RQD
selectionId                   Long                RQD
handicap                      Double              OPT
priceProjection               PriceProjection     OPT
orderProjection               OrderProjection     OPT
matchProjection               MatchProjection     OPT
includeOverallPosition        Boolean             OPT
partitionMatchedByStrategyRef Boolean             OPT
customerStrategyRefs          Array of Strings    OPT
currencyCode                  String              OPT
locale                        String              OPT
matchedSince                  Date                OPT
betIds                        Array of Strings    OPT

Return Value

Array Ref                     MarketBook

listMarketCatalogue($parameters)

my $return_value = $bf->listMarketCatalogue({filter => {}, maxResults => 1});

Returns a list of information about markets that does not change (or changes very rarely). You use listMarketCatalogue to retrieve the name of the market, the names of selections and other information about markets. Market Data Request Limits apply to requests made to listMarketCatalogue.

Parameters

filter            MarketFilter                 RQD
marketProjection  Array of MarketProjection    OPT
sort              MarketSort                   OPT
maxResults        Integer                      RQD
locale            String                       OPT

Return Value

Array Ref         MarketCatalogue

listMarketProfitAndLoss($parameters)

my $return_value = $bf->listMarketProfitAndLoss({marketIds => [<market id>]});

Retrieve profit and loss for a given list of markets. The values are calculated using matched bets and optionally settled bets. Only odds (MarketBettingType = ODDS) markets are implemented, markets of other types are silently ignored.

Parameters

marketIds         Array of Strings    RQD
includeSettledBets         Boolean    OPT
includeBspBets             Boolean    OPT
netOfCommission            Boolean    OPT

Return Value

Array Ref         MarketProfitAndLoss

listMarketTypes($parameters)

my $return_value = $bf->listMarketTypes({filter => {}});

Returns a list of market types (i.e. MATCH_ODDS, NEXT_GOAL) associated with the markets selected by the MarketFilter. The market types are always the same, regardless of locale

Parameters

filter            MarketFilter        RQD
locale            String (ISO 3166)   OPT

Return Value

Array Ref         MarketTypeResult

listTimeRanges($parameters)

my $return_value = $bf->listTimeRanges({filter => {}, granularity => 'DAYS'});

Returns a list of time ranges in the granularity specified in the request (i.e. 3PM to 4PM, Aug 14th to Aug 15th) associated with the markets selected by the MarketFilter.

Parameters

filter            MarketFilter        RQD
granularity       TimeGranularity     RQD

Return Value

Array Ref         TimeRangeResult

listVenues($parameters)

my $return_value = $bf->listVenues({filter => {}});

Returns a list of Venues (i.e. Cheltenham, Ascot) associated with the markets selected by the MarketFilter. Currently, only Horse Racing markets are associated with a Venue.

Parameters

filter            MarketFilter        RQD
locale            String (ISO 3166)   OPT

Return Value

Array Ref         VenueResult

placeOrders($parameters)

  my $return_value = $bf->placeOrders({marketId    => <market id>,
	                              instructions => [{
				             selectionId => <selection id>,
				                handicap => "0",
				                    side => "BACK",
				               orderType => "LIMIT",
		         	              limitOrder => {
				       	             size  => <bet size>,
					             price => <requested price>,
				           persistenceType => "LAPSE"
                                                            }
                                                      }]
                                     });

Place new orders into market. This operation is atomic in that all orders will be placed or none will be placed. Please note that additional bet sizing rules apply to bets placed into the Italian Exchange.

Parameters

marketId            String                      RQD
instructions        Array of PlaceInstruction   RQD
customerRef         String                      OPT
marketVersion       MarketVersion               OPT
customerStrategyRef String                      OPT
async               Boolean                     OPT

Return Value

customerRef         String
status              ExecutionReportStatus
errorCode           ExecutionReportErrorCode
marketId            String
instructionReports  Array of PlaceInstructionReport

cancelOrders([$parameters])

my $return_value = $bf->cancelOrders();

Cancel all bets OR cancel all bets on a market OR fully or partially cancel particular orders on a market. Only LIMIT orders can be cancelled or partially cancelled once placed. Calling this with no parameters will CANCEL ALL BETS.

Parameters

marketId          String                      OPT
instructions      Array of CancelInstruction  OPT
customerRef       String                      OPT

Return Value

customerRef       String
status            ExecutionReportStatus
errorCode         ExecutionReportErrorCode
marketId          String
instructionReports  Array of CancelInstructionReport

replaceOrders($parameters)

  my $return_value = $bf->replaceOrders({marketId => <market id>,
			             instructions => [{
                                               betId => <bet id>,
                                            newPrice => <new price>
                                                     }]
                                       });

This operation is logically a bulk cancel followed by a bulk place. The cancel is completed first then the new orders are placed. The new orders will be placed atomically in that they will all be placed or none will be placed. In the case where the new orders cannot be placed the cancellations will not be rolled back.

Parameters

marketId          String                      RQD
instructions      Array of ReplaceInstruction RQD
customerRef       String                      OPT
marketVersion     MarketVersion               OPT
async             Boolean                     OPT

Return Value

customerRef       String
status            ExecutionReportStatus
errorCode         ExecutionReportErrorCode
marketId          String
instructionReports  Array of ReplaceInstructionReport

updateOrders($parameters)

  my $return_value = $bf->updateOrders({marketId => <market id>,
			             instructions => [{
                                               betId => <bet id>,
                                  newPersistenceType => "LAPSE"
                                                     }]
                                       });

Update non-exposure changing fields.

Parameters

marketId          String                      RQD
instructions      Array of UpdateInstruction  RQD
customerRef       String                      OPT

Return Value

customerRef       String
status            ExecutionReportStatus
errorCode         ExecutionReportErrorCode
marketId          String
instructionReports  Array of UpdateInstructionReport

Accounts Operations

As with the Betting Operations, the descriptions of these methods are taken directly from the Betfair documentation. Once again, required parameters are denoted by RQD and optional ones by OPT. Some parameters are described in terms of BETFAIR DATA TYPES, which are described below.

createDeveloperAppKeys($parameters)

my $return_value = $bf->createDeveloperAppKeys(<application name>);

Create two application keys for given user; one active and the other delayed. NOTE as this call fails if the keys have already been created, it has NOT BEEN TESTED.

Parameters

appName           String              RQD

Return Value

appName           String
appId             Long
appVersions       Array of DeveloperAppVersion

getAccountDetails()

my $return_value = $bf->getAccountDetails();

Returns the details relating [to] your account, including your discount rate and Betfair point balance. Takes no parameters.

Return Value

currencyCode      String
firstName         String
lastName          String
localeCode        String
region            String
timezone          String
discountRate      Double
pointsBalance     Integer
countryCode       String

getAccountFunds()

my $return_value = $bf->getAccountFunds([$parameters]);

Get available to bet amount. The optional parameter 'wallet' was previously used to access Australian funds, but since 2016-09-20 these have been included in the main (UK) wallet.

Parameters

wallet            Wallet    OPT - DEPRECATED

Return Value

availableToBetBalance  Double
exposure               Double
retainedCommission     Double
exposureLimit          Double
discountRate           Double
pointsBalance          Integer

getDeveloperAppKeys()

my $return_value = $bf->getDeveloperAppKeys();

Get all application keys owned by the given developer/vendor. Takes no parameters.

Return Value

Array Ref         DeveloperApp

getAccountStatement([$parameters])

my $return_value = $bf->getAccountStatement();

Get Account Statement.

Parameters

locale            String              OPT
fromRecord        Integer             OPT
recordCount       Integer             OPT
itemDateRange     TimeRange           OPT
includeItem       IncludeItem         OPT
wallet            Wallet              OPT

Return Value

accountStatement  Array of StatementItem
moreAvailable     Boolean

listCurrencyRates([$parameters])

my $return_value = $bf->listCurrencyRates();

Returns a list of currency rates based on given currency.

Parameters

fromCurrency      String              OPT

Return Value

Array Ref         CurrencyRate

transferFunds($parameters) - DEPRECATED

my $return_value = $bf->transferFunds({from   => 'UK',
                                       to     => 'AUSTRALIAN',
                                       amount => <amount> });

Transfer funds between different wallets. With the removal of the Australian wallet on 2016-09-20 this method is currently DEPRECATED, although it has been retained as the introduction of alternative wallets for ringfencing funds etc. has been mooted by Betfair on the forum.

Parameters

from              Wallet    RQD
to                Wallet    RQD
amount            Double    RQD

Return Value

transactionId     String

This has only one method (navigationMenu()), which retrieves the full Betfair navigation menu from a compressed file which is updated every five minutes.

navigationMenu()

my $menu = $bf->navigationMenu()

Returns a huge hash containing descriptions of all Betfair markets arranged in a tree structure. The root of the tree is a GROUP entity called 'ROOT', from which hang a number of EVENT_TYPE entities. Each of these can have a number of GROUP or EVENT entities as children, which in turn can have GROUP or EVENT children of their own. EVENTs may also have individual MARKETs as children, whereas GROUPs may not. MARKETs never have childen, and so are always leaf-nodes, but be aware that the same MARKET may appear at the end of more than one branch of the tree. This is especially true where RACEs are concerned; a RACE is yet another entity, which currently may only hang off the EVENT_TYPE identified by the id '7' and the name 'Horse Racing'. A RACE may only have MARKETs as children, and these will typically also appear elsewhere in the tree. Takes no parameters (so it's all or nothing at all).

Return Value

children          Array of EVENT_TYPE
id                Integer (always '0' for ROOT)
name              String  (always 'ROOT' for ROOT)
type              Menu entity type (always 'GROUP' for ROOT)

Menu Entity Types

EVENT_TYPE

children          Array of GROUP, EVENT and/or RACE
id                String, will be the same as EventType id
name              String, will be the same as EventType name
type              Menu entity type (EVENT_TYPE)


GROUP

children          Array of GROUP and/or EVENT
id                String
name              String
type              Menu entity type (GROUP)

EVENT

children          Array of GROUP, EVENT and/or MARKET
id                String, will be the same as Event id
name              String, will be the same as Event name
countryCode       ISO 3166 2-Character Country Code
type              Menu entity type (EVENT)

RACE

children          Array of MARKET
id                String
name              String
type              Menu entity type (RACE)
startTime         Date
countryCode       ISO 3166 2-Character Country Code
venue             String (Course name in full)

MARKET

exchangeId        String (Currently always '1')
id                String, will be the same as Market id
marketStartTime   Date
marketType        MarketType (e.g. 'WIN', 'PLACE')
numberOfWinners   No. of winners (used in 'PLACE' markets)
name              String, will be the same as Market name
type              Menu entity type (MARKET)

Heartbeat API

This Heartbeat operation is provided to allow customers to automatically cancel their unmatched bets in the event of their API client losing connectivity with the Betfair API.

heartbeat($parameters)

my $return_value = $bf->heartbeat({preferredTimeoutSeconds => <timeout>});

This heartbeat operation is provided to help customers have their positions managed automatically in the event of their API clients losing connectivity with the Betfair API. If a heartbeat request is not received within a prescribed time period, then Betfair will attempt to cancel all 'LIMIT' type bets for the given customer on the given exchange. There is no guarantee that this service will result in all bets being cancelled as there are a number of circumstances where bets are unable to be cancelled. Manual intervention is strongly advised in the event of a loss of connectivity to ensure that positions are correctly managed. If this service becomes unavailable for any reason, then your heartbeat will be unregistered automatically to avoid bets being inadvertently cancelled upon resumption of service. you should manage your position manually until the service is resumed. Heartbeat data may also be lost in the unlikely event of nodes failing within the cluster, which may result in your position not being managed until a subsequent heartbeat request is received.

Parameters

preferredTimeoutSeconds  Integer      RQD

Return Value

actionPerformed          ActionPerformed
actualTimeoutSeconds     Integer

Race Status API

The listRaceDetails operation is provided to allow customers to establish the status of a horse or greyhound race market both prior to and after the start of the race. This information is available for UK and Ireland races only.

listRaceDetails($parameters)

my $return_value = $bf->listRaceDetails();

Search for races to get their details. 'meetingIds' optionally restricts the results to the specified meeting IDs. The unique Id for the meeting equivalent to the eventId for that specific race as returned by listEvents. 'raceIds' optionally restricts the results to the specified race IDs. The unique Id for the race in the format meetingid.raceTime (hhmm). raceTime is in UTC.

Parameters

meetingIds     Array of Strings     OPT
raceIds        Array of Strings     OPT

Return Value

ArrayRef       RaceDetails

BETFAIR DATA TYPES

This is an alphabetical list of all the data types defined by Betfair. It includes enumerations, which are just sets of allowable string values. Higher level types may contain lower level types, which can be followed down until simple scalars are reached. Some elements of complex data types are required, while others are optional - these are denoted by RQD and OPT respectively. Simple scalar type definitions (Long, Double, Integer, String, Boolean, Date) have been retained for convenience. 'Date' is a string in ISO 8601 format (e.g. '2007-04-05T14:30Z').

ActionPerformed

Enumeration

NONE                              No action was performed since last heartbeat
CANCELLATION_REQUEST_SUBMITTED    A request to cancel all unmatched bets was submitted
ALL_BETS_CANCELLED                All unmatched bets were cancelled since last heartbeat
SOME_BETS_NOT_CANCELLED           Not all unmatched bets were cancelled
CANCELLATION_REQUEST_ERROR        There was an error requesting cancellation
CANCELLATION_STATUS_UNKNOWN       There was no response from requesting cancellation

BetStatus

Enumeration

SETTLED     A matched bet that was settled normally.
VOIDED      A matched bet that was subsequently voided by Betfair.
LAPSED      Unmatched bet that was cancelled by Betfair (for example at turn in play).
CANCELLED   Unmatched bet that was cancelled by an explicit customer action.

BetTargetType

Enumeration

BACKERS_PROFIT The payout requested minus the size at which this LimitOrder is to be placed.
PAYOUT         The total payout requested on a LimitOrder.

CancelInstruction

betId             String              RQD
sizeReduction     Double              OPT

CancelInstructionReport

status            InstructionReportStatus
errorCode         InstructionReportErrorCode
instruction       CancelInstruction
sizeCancelled     Double
cancelledDate     Date

ClearedOrderSummary

eventTypeId       String
eventId           String
marketId          String
selectionId       Long
handicap          Double
betId             String
placedDate        Date
persistenceType   PersistenceType
orderType         OrderType
side              Side
itemDescription   ItemDescription
priceRequested    Double
settledDate       Date
betCount          Integer
commission        Double
priceMatched      Double
priceReduced      Boolean
sizeSettled       Double
profit            Double
sizeCancelled     Double
lastMatchedDate   Date
betOutcome        String

Competition

id                String
name              String

CompetitionResult

competition       Competition
marketCount       Integer
competitionRegion String

CountryCodeResult

countryCode       String
marketCount       Integer

CurrencyRate

currencyCode      String (Three letter ISO 4217 code)
rate              Double

CurrentOrderSummary

betId               String
marketId            String
selectionId         Long
handicap            Double
priceSize           PriceSize
bspLiability        Double
side                Side
status              OrderStatus
persistenceType     PersistenceType
orderType           OrderType
placedDate          Date
matchedDate         Date
averagePriceMatched Double
sizeMatched         Double
sizeRemaining       Double
sizeLapsed          Double
sizeCancelled       Double
sizeVoided          Double
regulatorAuthCode   String
regulatorCode       String

DeveloperApp

appName           String
appId             Long
appVersions       Array of DeveloperAppVersion

DeveloperAppVersion

owner                       String
versionId                   Long
version                     String
applicationKey              String
delayData                   Boolean
subscriptionRequired        Boolean
ownerManaged                Boolean
active                      Boolean

Event

id                String
name              String
countryCode       String
timezone          String
venue             String
openDate          Date

EventResult

event             Event
marketCount       Integer

EventType

id                String
name              String

EventTypeResult

eventType         EventType
marketCount       Integer

ExBestOffersOverrides

bestPricesDepth             Integer       OPT
rollupModel                 RollupModel   OPT
rollupLimit                 Integer       OPT
rollupLiabilityThreshold    Double        OPT
rollupLiabilityFactor       Integer       OPT

ExchangePrices

availableToBack             Array of PriceSize
availableToLay              Array of PriceSize
tradedVolume                Array of PriceSize

ExecutionReportErrorCode

Enumeration

ERROR_IN_MATCHER            The matcher is not healthy.
PROCESSED_WITH_ERRORS       The order itself has been accepted, but at least one action has generated errors.
BET_ACTION_ERROR            There is an error with an action that has caused the entire order to be rejected.
INVALID_ACCOUNT_STATE       Order rejected due to the account's status (suspended, inactive, dup cards).
INVALID_WALLET_STATUS       Order rejected due to the account's wallet's status.
INSUFFICIENT_FUNDS          Account has exceeded its exposure limit or available to bet limit.
LOSS_LIMIT_EXCEEDED         The account has exceed the self imposed loss limit.
MARKET_SUSPENDED            Market is suspended.
MARKET_NOT_OPEN_FOR_BETTING Market is not open for betting. It is either not yet active, suspended or closed.
DUPLICATE_TRANSACTION       duplicate customer reference data submitted.
INVALID_ORDER               Order cannot be accepted by the matcher due to the combination of actions.
INVALID_MARKET_ID           Market doesn't exist.
PERMISSION_DENIED           Business rules do not allow order to be placed.
DUPLICATE_BETIDS            duplicate bet ids found.
NO_ACTION_REQUIRED          Order hasn't been passed to matcher as system detected there will be no change.
SERVICE_UNAVAILABLE         The requested service is unavailable.
REJECTED_BY_REGULATOR       The regulator rejected the order.

ExecutionReportStatus

Enumeration

SUCCESS               Order processed successfully.
FAILURE               Order failed.
PROCESSED_WITH_ERRORS The order itself has been accepted, but at least one action has generated errors.
TIMEOUT               Order timed out.

GroupBy

Enumeration

EVENT_TYPE A roll up on a specified event type.
EVENT      A roll up on a specified event.
MARKET     A roll up on a specified market.
SIDE       An averaged roll up on the specified side of a specified selection.
BET        The P&L, commission paid, side and regulatory information etc, about each individual bet order

IncludeItem

Enumeration

ALL                         Include all items.
DEPOSITS_WITHDRAWALS        Include payments only.
EXCHANGE                    Include exchange bets only.
POKER_ROOM                  include poker transactions only.

InstructionReportErrorCode

Enumeration

INVALID_BET_SIZE                Bet size is invalid for your currency or your regulator.
INVALID_RUNNER                  Runner does not exist, includes vacant traps in greyhound racing.
BET_TAKEN_OR_LAPSED             Bet cannot be cancelled or modified as it has already been taken or has lapsed.
BET_IN_PROGRESS                 No result was received from the matcher in a timeout configured for the system.
RUNNER_REMOVED                  Runner has been removed from the event.
MARKET_NOT_OPEN_FOR_BETTING     Attempt to edit a bet on a market that has closed.
LOSS_LIMIT_EXCEEDED             The action has caused the account to exceed the self imposed loss limit.
MARKET_NOT_OPEN_FOR_BSP_BETTING Market now closed to bsp betting. Turned in-play or has been reconciled.
INVALID_PRICE_EDIT              Attempt to edit down a bsp limit on close lay bet, or edit up a back bet.
INVALID_ODDS                    Odds not on price ladder - either edit or placement.
INSUFFICIENT_FUNDS              Insufficient funds available to cover the bet action.
INVALID_PERSISTENCE_TYPE        Invalid persistence type for this market.
ERROR_IN_MATCHER                A problem with the matcher prevented this action completing successfully
INVALID_BACK_LAY_COMBINATION    The order contains a back and a lay for the same runner at overlapping prices.
ERROR_IN_ORDER                  The action failed because the parent order failed.
INVALID_BID_TYPE                Bid type is mandatory.
INVALID_BET_ID                  Bet for id supplied has not been found.
CANCELLED_NOT_PLACED            Bet cancelled but replacement bet was not placed.
RELATED_ACTION_FAILED           Action failed due to the failure of a action on which this action is dependent.
NO_ACTION_REQUIRED              The action does not result in any state change.

InstructionReportStatus

Enumeration

SUCCESS     Action succeeded.
FAILURE     Action failed.
TIMEOUT     Action Timed out.

ItemClass

Enumeration

UNKNOWN     Statement item not mapped to a specific class.

ItemDescription

eventTypeDesc     String
eventDesc         String
marketDesc        String
marketStartTime   Date
runnerDesc        String
numberOfWinners   Integer
marketType        String
eachWayDivisor    Double

LimitOnCloseOrder

liability         Double              REQ
price             Double              REQ

LimitOrder

size              Double              REQ/OPT*
price             Double              REQ
persistenceType   PersistenceType     REQ
timeInForce       TimeInForce         OPT
minFillSize       Double              OPT
betTargetType     BetTargetType       OPT/REQ*
betTargetSize     Double              OPT/REQ*

* Must specify EITHER size OR target type and target size

MarketBettingType

Enumeration

ODDS                        Odds Market.
LINE                        Line Market.
RANGE                       Range Market.
ASIAN_HANDICAP_DOUBLE_LINE  Asian Handicap Market.
ASIAN_HANDICAP_SINGLE_LINE  Asian Single Line Market.
FIXED_ODDS                  Sportsbook Odds Market.

MarketBook

marketId              String
isMarketDataDelayed   Boolean
status                MarketStatus
betDelay              Integer
bspReconciled         Boolean
complete              Boolean
inplay                Boolean
numberOfWinners       Integer
numberOfRunners       Integer
numberOfActiveRunners Integer
lastMatchTime         Date
totalMatched          Double
totalAvailable        Double
crossMatching         Boolean
runnersVoidable       Boolean
version               Long
runners               Array of Runner

MarketCatalogue

marketId          String
marketName        String
marketStartTime   Date
description       MarketDescription
totalMatched      Double
runners           Array of RunnerCatalog
eventType         EventType
competition       Competition
event             Event

MarketDescription

persistenceEnabled Boolean
bspMarket          Boolean
marketTime         Date
suspendTime        Date
settleTime         Date
bettingType        MarketBettingType
turnInPlayEnabled  Boolean
marketType         String
regulator          String
marketBaseRate     Double
discountAllowed    Boolean
wallet             String
rules              String
rulesHasDate       Boolean
eachWayDivisor     Double
clarifications     String

MarketFilter

textQuery          String                       OPT
exchangeIds        Array of String              OPT
eventTypeIds       Array of String              OPT
eventIds           Array of String              OPT
competitionIds     Array of String              OPT
marketIds          Array of String              OPT
venues             Array of String              OPT
bspOnly            Boolean                      OPT
turnInPlayEnabled  Boolean                      OPT
inPlayOnly         Boolean                      OPT
marketBettingTypes Array of MarketBettingType   OPT
marketCountries    Array of String              OPT
marketTypeCodes    Array of String              OPT
marketStartTime    TimeRange                    OPT
withOrders         Array of OrderStatus         OPT

MarketOnCloseOrder

liability          Double              REQ

MarketProfitAndLoss

marketId           String
commissionApplied  Double
profitAndLosses    Array of RunnerProfitAndLoss

MarketProjection

Enumeration

COMPETITION        If not selected then the competition will not be returned with marketCatalogue.
EVENT              If not selected then the event will not be returned with marketCatalogue.
EVENT_TYPE         If not selected then the eventType will not be returned with marketCatalogue.
MARKET_START_TIME  If not selected then the start time will not be returned with marketCatalogue.
MARKET_DESCRIPTION If not selected then the description will not be returned with marketCatalogue.
RUNNER_DESCRIPTION If not selected then the runners will not be returned with marketCatalogue.
RUNNER_METADATA    If not selected then the runner metadata will not be returned with marketCatalogue.

MarketSort

Enumeration

MINIMUM_TRADED     Minimum traded volume
MAXIMUM_TRADED     Maximum traded volume
MINIMUM_AVAILABLE  Minimum available to match
MAXIMUM_AVAILABLE  Maximum available to match
FIRST_TO_START     The closest markets based on their expected start time
LAST_TO_START      The most distant markets based on their expected start time

MarketStatus

Enumeration

INACTIVE           Inactive Market
OPEN               Open Market
SUSPENDED          Suspended Market
CLOSED             Closed Market

MarketTypeResult

marketType        String
marketCount       Integer

MarketVersion

version           Long                REQ

Match

betId             String
matchId           String
side              Side
price             Double
size              Double
matchDate         Date

MatchProjection

Enumeration

NO_ROLLUP              No rollup, return raw fragments.
ROLLED_UP_BY_PRICE     Rollup matched amounts by distinct matched prices per side.
ROLLED_UP_BY_AVG_PRICE Rollup matched amounts by average matched price per side.

Order

betId             String
orderType         OrderType
status            OrderStatus
persistenceType   PersistenceType
side              Side
price             Double
size              Double
bspLiability      Double
placedDate        Date
avgPriceMatched   Double
sizeMatched       Double
sizeRemaining     Double
sizeLapsed        Double
sizeCancelled     Double
sizeVoided        Double

OrderBy

Enumeration

BY_BET          Deprecated Use BY_PLACE_TIME instead. Order by placed time, then bet id.
BY_MARKET       Order by market id, then placed time, then bet id.
BY_MATCH_TIME   Order by time of last matched fragment (if any), then placed time, then bet id.
BY_PLACE_TIME   Order by placed time, then bet id. This is an alias of to be deprecated BY_BET.
BY_SETTLED_TIME Order by time of last settled fragment, last match time, placed time, bet id.
BY_VOID_TIME    Order by time of last voided fragment, last match time, placed time, bet id.

OrderProjection

Enumeration

ALL                EXECUTABLE and EXECUTION_COMPLETE orders.
EXECUTABLE         An order that has a remaining unmatched portion.
EXECUTION_COMPLETE An order that does not have any remaining unmatched portion.

OrderStatus

Enumeration

PENDING            An asynchronous order is yet to be processed. NOT A VALID SEARCH CRITERIA.
EXECUTION_COMPLETE An order that does not have any remaining unmatched portion.
EXECUTABLE         An order that has a remaining unmatched portion.
EXPIRED            Unfilled FILL_OR_KILL order. NOT A VALID SEARCH CRITERIA.

OrderType

Enumeration

LIMIT             A normal exchange limit order for immediate execution.
LIMIT_ON_CLOSE    Limit order for the auction (SP).
MARKET_ON_CLOSE   Market order for the auction (SP).

PersistenceType

Enumeration

LAPSE           Lapse the order when the market is turned in-play.
PERSIST         Persist the order to in-play.
MARKET_ON_CLOSE Put the order into the auction (SP) at turn-in-play.

PlaceInstruction

orderType          OrderType            RQD
selectionId        Long                 RQD
handicap           Double               OPT
side               Side                 RQD
limitOrder         LimitOrder           OPT/RQD \
limitOnCloseOrder  LimitOnCloseOrder    OPT/RQD  > Depending on OrderType
marketOnCloseOrder MarketOnCloseOrder   OPT/RQD /

PlaceInstructionReport

status              InstructionReportStatus
errorCode           InstructionReportErrorCode
instruction         PlaceInstruction
betId               String
placedDate          Date
averagePriceMatched Double
sizeMatched         Double

PriceData

Enumeration

SP_AVAILABLE      Amount available for the BSP auction.
SP_TRADED         Amount traded in the BSP auction.
EX_BEST_OFFERS    Only the best prices available for each runner, to requested price depth.
EX_ALL_OFFERS     EX_ALL_OFFERS trumps EX_BEST_OFFERS if both settings are present.
EX_TRADED         Amount traded on the exchange.

PriceProjection

priceData             Array of PriceData        OPT
exBestOffersOverrides ExBestOffersOverrides     OPT
virtualise            Boolean                   OPT
rolloverStakes        Boolean                   OPT

PriceSize

price             Double
size              Double

ReplaceInstruction

betId             String              RQD
newPrice          Double              RQD

RaceDetails

meetingId         String
raceId            String
raceStatus        RaceStatus
lastUpdated       Date
responseCode      ResponseCode

RaceStatus

Enumeration

DORMANT           There is no data available for this race
DELAYED           The start of the race has been delayed
PARADING          The horses are in the parade ring
GOINGDOWN         The horses are going down to the starting post
GOINGBEHIND       The horses are going behind the stalls
ATTHEPOST         The horses are at the post
UNDERORDERS       The horses are loaded into the stalls/race is about to start
OFF               The race has started
FINISHED          The race has finished
FALSESTART        There has been a false start
PHOTOGRAPH        The result of the race is subject to a photo finish
RESULT            The result of the race has been announced
WEIGHEDIN         The jockeys have weighed in
RACEVOID          The race has been declared void
ABANDONED         The meeting has been cancelled
APPROACHING       The greyhounds are approaching the traps
GOINGINTRAPS      The greyhounds are being put in the traps
HARERUNNING       The hare has been started
FINALRESULT       The result cannot be changed for betting purposes.
NORACE            The race has been declared a no race
RERUN             The race will be rerun

ReplaceInstructionReport

status                  InstructionReportStatus
errorCode               InstructionReportErrorCode
cancelInstructionReport CancelInstructionReport
placeInstructionReport  PlaceInstructionReport

ResponseCode

Enumeration

OK                                  Data returned successfully
NO_NEW_UPDATES                      No updates since the passes UpdateSequence
NO_LIVE_DATA_AVAILABLE              Event scores are no longer available
SERVICE_UNAVAILABLE                 Data feed for the event type is currently unavailable
UNEXPECTED_ERROR                    An unexpected error occurred retrieving score data
LIVE_DATA_TEMPORARILY_UNAVAILABLE   Live Data feed is temporarily unavailable

RollupModel

Enumeration

STAKE             The volumes will be rolled up to the minimum value which is >= rollupLimit.
PAYOUT            The volumes will be rolled up to the minimum value where the payout( price * volume ) is >= rollupLimit.
MANAGED_LIABILITY The volumes will be rolled up to the minimum value which is >= rollupLimit, until a lay price threshold.
NONE              No rollup will be applied.

Runner

selectionId       Long
handicap          Double
status            RunnerStatus
adjustmentFactor  Double
lastPriceTraded   Double
totalMatched      Double
removalDate       Date
sp                StartingPrices
ex                ExchangePrices
orders            Array of Order
matches           Array of Match

RunnerCatalog

selectionId       Long
runnerName        String
handicap          Double
sortPriority      Integer
metadata          Hash of Metadata

RunnerProfitAndLoss

selectionId       Long
ifWin             Double
ifLose            Double

RunnerStatus

Enumeration

ACTIVE            Active in a live market.
WINNER            Winner in a settled market.
LOSER             Loser in a settled market.
PLACED            The runner was placed, applies to EACH_WAY marketTypes only.
REMOVED_VACANT    Vacant (e.g. Trap in a dog race).
REMOVED           Removed from the market.
HIDDEN            Hidden from the market.

Side

Enumeration

BACK  To bet on the selection to win.
LAY   To bet on the selection to lose.

SortDir

Enumeration

EARLIEST_TO_LATEST          Order from earliest value to latest.
LATEST_TO_EARLIEST          Order from latest value to earliest.

StartingPrices

nearPrice                   Double
farPrice                    Double
backStakeTaken              Array of PriceSize
layLiabilityTaken           Array of PriceSize
actualSP                    Double

StatementItem

refId             String
itemDate          Date
amount            Double
balance           Double
itemClass         ItemClass
itemClassData     Hash of ItemClassData
legacyData        StatementLegacyData

StatementLegacyData

avgPrice                    Double
betSize                     Double
betType                     String
betCategoryType             String
commissionRate              String
eventId                     Long
eventTypeId                 Long
fullMarketName              String
grossBetAmount              Double
marketName                  String
marketType                  String
placedDate                  Date
selectionId                 Long
selectionName               String
startDate                   Date
transactionType             String
transactionId               Long
winLose                     String

TimeGranularity

Enumeration

DAYS              Days.
HOURS             Hours.
MINUTES           Minutes.

TimeInForce

Enumeration

FILL_OR_KILL Execute the transaction immediately  or not at all.

TimeRange

from              Date      OPT
to                Date      OPT

TimeRangeResult

timeRange         TimeRange
marketCount       Integer

UpdateInstruction

betId              String             RQD
newPersistenceType PersistenceType    RQD

UpdateInstructionReport

status            InstructionReportStatus
errorCode         InstructionReportErrorCode
instruction       UpdateInstruction

Wallet

Enumeration

UK                UK Exchange wallet.
AUSTRALIAN        Australian Exchange wallet. DEPRECATED

THREADS

Because the betfair object maintains a persistent encrypted connection to the Betfair servers, it should NOT be considered 100% thread-safe. In particular, using the same $bf object to make API calls across different threads will usually result in disaster. In practice, there are at least two ways to solve this problem and use WWW::BetfairNG safely in threaded applications:-

'Postbox' Thread

If simultaneous or overlapping calls to betfair are not required, one solution is to make all calls from a single, dedicated thread. This thread can wait on a queue created by Thread::Queue for requests from other threads, and return the result to them, again via a queue. Only one $bf object is required in this scenario, which may be created by the 'postbox' thread itself or, less robustly, by the parent thread before the 'postbox' is spawned. In the latter case, no other thread (including the parent) should use the $bf object once the 'postbox' has started using it.

Multiple Objects

If you need to make simultaneous or overlapping calls to betfair, you can create a new $bf object in each thread that makes betfair calls. As betfair sessions are identified by a simple scalar session token, a single login will create a session which CAN be safely shared across threads:-

use WWW::BetfairNG;
use threads;
use threads::shared;

my $parent_bf = WWW::BetfairNG->new({
                                     ssl_cert => '<path to ssl certificate file>',
                                     ssl_key  => '<path to ssl key file>',
                                     app_key  => '<application key value>',
                                     });
$parent_bf->login({username => <username>, password => <password>})
  or die;
my $session :shared = $parent_bf->session();

my $child = threads->create(sub {
  # Create a new bf object in the child - no need for ssl cert and key
  my $child_bf = WWW::BetfairNG->new({app_key  => '<application key value>'});
  # Assign the shared session token - $child_bf will then be logged in
  $child_bf->session($session);

      # Make any required API calls in the child using $child_bf
});

# Freely make API calls using $parent_bf

$child->join;
$parent_bf->logout; # Logs out any children using the same session token
exit 0;

In particular, keepAlive calls only need to be made in one thread to affect all threads using the same session token, and logging out in any thread will log out all threads using the same session token.

AUTHOR

Myrddin Wyllt, <myrddinwyllt@tiscali.co.uk>

ACKNOWLEDGEMENTS

Main inspiration for this was David Farrell's WWW::betfair module, which was written for the v6 SOAP interface. Thanks also to Carl O'Rourke for suggestions on clarifying error messages, Colin Magee for the suggestion to extend the timeout period for the navigationMenu call and David Halstead for spotting a bug in the selectionId parameter check.

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

To install WWW::BetfairNG, copy and paste the appropriate command in to your terminal.

cpanm

cpanm WWW::BetfairNG

CPAN shell

perl -MCPAN -e shell
install WWW::BetfairNG

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)

NAME

VERSION

SYNOPSIS

DESCRIPTION

METHODS

Construction and Setup

new([$parameters])

Accessors

ssl_cert([<path to ssl cert file>])

ssl_key([<path to ssl key file>])

app_key([<key value>])

session()

check_parameters()

australian() *DEPRECATED*

error()

response()

API CALLS

Session Methods

login({username => 'username', password => 'password'})

interactiveLogin({username => 'username', password => 'password'})

logout()

keepAlive()

Betting Operations

listCompetitions($parameters)

listCountries($parameters)

listCurrentOrders([$parameters])

listClearedOrders([$parameters])

listEvents($parameters)

listEventTypes($parameters)

listMarketBook($parameters)

listRunnerBook($parameters)

listMarketCatalogue($parameters)

listMarketProfitAndLoss($parameters)

listMarketTypes($parameters)

listTimeRanges($parameters)

listVenues($parameters)

placeOrders($parameters)

cancelOrders([$parameters])

replaceOrders($parameters)

updateOrders($parameters)

Accounts Operations

createDeveloperAppKeys($parameters)

getAccountDetails()

getAccountFunds()

getDeveloperAppKeys()

getAccountStatement([$parameters])

listCurrencyRates([$parameters])

transferFunds($parameters) - DEPRECATED

Navigation Data for Applications

navigationMenu()

Heartbeat API

heartbeat($parameters)

Race Status API

listRaceDetails($parameters)

BETFAIR DATA TYPES

ActionPerformed

BetStatus

BetTargetType

CancelInstruction

CancelInstructionReport

ClearedOrderSummary

Competition

CompetitionResult

CountryCodeResult

CurrencyRate

CurrentOrderSummary

DeveloperApp

DeveloperAppVersion

Event

EventResult

EventType

EventTypeResult

ExBestOffersOverrides

ExchangePrices

ExecutionReportErrorCode

ExecutionReportStatus

GroupBy

IncludeItem

InstructionReportErrorCode

InstructionReportStatus

australian() DEPRECATED