mb_bet_place: Perform a Bet Placement Action
In matchbook: Wrapper for the 'Matchbook' API

Description Usage Arguments Value See Also Examples

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.

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

`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.

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.

mb_get_bets

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)