Operation
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.
Parameter name | Type | Required | Description |
|---|---|---|---|
marketId | String |
| The market id these orders are to be placed on |
instructions | List< PlaceInstruction > |
| The number of place instructions. The limit of place instructions per request is 200. |
customerRef | String | Optional parameter allowing the client to pass a unique string (up to 32 chars) that is used to de-dupe mistaken re-submissions. CustomerRef can contain: upper/lower chars, digits, chars : - . _ + * : ; ~ only. Please note: There is a time window associated with the de-duplication of duplicate submissions which is 60 seconds. |
Return type | Description |
|---|---|
Throws | Description |
|---|---|
Generic exception that is thrown if this operation fails for any reason. |
Since 1.0.0
Each Way Betting
Each Way betting is available via the API. Each Way markets can be identified as marketType EACH_WAY using listMarketCatalogue.
Please see table a table that indicates how the “Each-Way divisor" is determined for specific race types:
Race Type | Number of Runners(1) | Number of Places | Fraction of Win Odds “Each-Way divisor" |
Handicap | 16 or more | 4 | 1/4 |
Handicap | 12 to 15 | 3 | 1/4 |
Handicap | 8 to 11 | 3 | 1/5 |
Handicap | 5 to 7 | 2 | 1/4 |
Non-Handicap | 8 or more | 3 | 1/5 |
Non-Handicap | 5 to 7 | 2 | 1/4 |
(1) Number of Runners at Market creation time; place terms are fixed for the life of the market (like Betfair Place market) not dependent on number of runners at the off (like Fixed Odds EW markets)
We will not offer EW markets if the number of runners at market creation time is 4 or fewer
Please Note: To determine if the race is a 'Handicap' via the API you will need to parse the marketName returned by the corresponding 'WIN' market for the Handicap (‘Hcap’) abbreviation.
Betfair Price Increments
Below is a list of price increments per price 'group'. Placing a bet outside of these increments will result in an INVALID_ODDS error
Odds Markets
Price | Increment |
|---|---|
| 1.01 → 2 | 0.01 |
| 2→ 3 | 0.02 |
| 3 → 4 | 0.05 |
| 4 → 6 | 0.1 |
| 6 → 10 | 0.2 |
| 10 → 20 | 0.5 |
| 20 → 30 | 1 |
| 30 → 50 | 2 |
| 50 → 100 | 5 |
| 100 → 1000 | 10 |
Asian Handicap & Total Goal Markets
Price | Increment |
|---|---|
| 1.01 → 1000 | 0.01 |
Currency Parameters
Guide to available currencies and minimum bet sizes.
Currency name | Symbol | Min Bet Size | Min Deposit Size | Minimum BSP Liability
|
|---|---|---|---|---|
| UK Sterling | £ | 2 | 10 | 10 |
| Euro | € | 2 | 15 | 20 |
| US Dollar | US$ | 4 | 15 | 20 |
| Hong Kong Dollars | HK$ | 25 | 150 | 125 |
| Australian Dollar | AUD | 5 | 30 | 30 |
| Canadian Dollar | CAD | 6 | 25 | 30 |
| Danish Kroner | DKK | 30 | 150 | 150 |
| Norwegian Kronor | NOK | 30 | 150 | 150 |
| Swedish Krona | SEK | 30 | 150 | 150 |
| Singapore Dollar | SGD | 6 | 30 | 30 |