View Source

Operation

PlaceExecutionReport placeOrders ( StringmarketId , List< PlaceInstruction >instructions, String customerRef, MarketVersion marketVersion, String customerStrategyRef ) throws APINGException

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 for the UK/AUS Exchange and 50 for the Italian Exchange.
customerRef	String	FOR FUTURE USE	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.
marketVersion	MarketVersion		Optional parameter allowing the client to specify which version of the market the orders should be placed on. If the current market version is higher than that sent on an order, the bet will be lapsed.
customerStrategyRef	String	FOR FUTURE USE	An optional reference customers can use to specify which strategy has sent the order. The reference will be returned on order change messages through the stream API. The string is limited to 15 characters. If an empty string is provided it will be treated as null.

Return type	Description
PlaceExecutionReport

Throws	Description
APINGException	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. The divisor that applies to the EACH_WAY market is returned by listMarketCatalogue via the MARKET_DESCRIPTION MarketProjection.

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

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