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

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

  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.

  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.

SEE ALSO

The Betfair Developer's Website https://developer.betfair.com/ In particular, the Exchange API Documentation and the Forum.

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

Copyright (C) 2017 by Myrddin Wyllt

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