mb_bet_place: Perform a Bet Placement Action

Description Usage Arguments Value See Also Examples

Description

This function provide the core bet placement functionality. Its possible to place a single bet by entering in a single value for each of the runner_id, side, odds and stake parameters. It also possible to place multiple bets at once by passing a vector for each of the runner_id, side, odds and stake parameters. In this instance, its imperative that the order in each of the vectors is preserved i.e. that the runner_id, side, odds and stake for the first bet are the first elements of each parameter vector, and that the runner_id, side, odds and stake values for the second bet are the second elements of each parameter vector and so on. There is a cap of 20 on the number of bets that can be placed at one time. NOTE: its is very important to note the 'status' field returned after executing this function to ensure that you be has been matched as you expect. See description for more details.

Usage

1
mb_bet_place(session_data, runner_id, side, stake, odds)

Arguments

session_data

A session object returned from a successful mb_login attempt. It contains details about your user preferences and security details.

runner_id

The id of the runner that you want to place a bet on.

side

The side that you want place a bet. This has to be one of either 'back' or 'lay'.

stake

The amount that want to stake for this bet. The currency used is the currency you specified when you set up your Matchbook.com account. A real number format is required.

odds

The odds you want to place a bet at. The odds type is based on the information from your session_data, which is the default setting saved for your account.

Value

The status and details of your bet placement are returned. The data frame has the following fields:

id

the bet id

event-id

the event id on which the bet was placed

event-name

the name of the event on which the bet was placed

event-id

the event id on which the bet was placed

market-id

the market id on which the bet was placed

market-name

the name of the market on which the bet was placed

runner-id

the runner id on which the bet was placed

runner-name

the name of the runner on which the bet was placed

side

the side the bet was placed on

odds

the odds the bet was placed on

decimal-odds

the decimal version of the odds

stake

the stake placed

remaining

this field indicates how much of the original stake placed remains unmatched. If this value is equal to the original stake, the the bet is fully un-matched. If this value is zero, then the bet has been fully matched. Any value in-between indicates a partial match

potential-profit

the potential profit if the matched component of this wager is successful

remaining-potential-profit

the potential profit if the un-matched component of this wager is first matched and then has a successful outcome

currency

The currency the bet stake was placed with

created-at

The date the bet was placed

status

The bet status. Status 'open' indicates an unmatched bet, 'matched' indicates a fully matched bet, 'cancelled' indicates a cancelled bet, 'failed' indicates a failed bet placement. For bets with status='open', the 'stake' and 'remaining' fields are key to determining the exact status. If the 'remaining' value is less than 'stake' but greater than zero, then the bet has been partially matched for a 'stake'-'remaining' amount. If the bet is fully un-matched, then the 'stake' and 'remaining' values will be equal.

See Also

mb_get_bets

Examples

1
2
3
## Not run: my_session <- mb_login("my_user_name","verysafepassword"); 
mb_bet_place(session_data=my_session,odds=2.5,stake=5,runner_id=12345)
## End(Not run)

matchbook documentation built on May 2, 2019, 5:49 a.m.