Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 22 Next »

Operation

placeOrders
PlaceExecutionReport placeOrders ( StringmarketId , List< PlaceInstruction >instructions ,StringcustomerRef ) 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

(tick)

The market id these orders are to be placed on

instructions

List< PlaceInstruction >

(tick)

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

 

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. Useful when a customer doesn't want to bet in play and is worried 
that their bet might arrive after the market has turned in play.

customerStrategyRef

String

 

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 → 20.01
2→ 30.02
3 → 40.05
4 → 60.1
6 → 100.2
10 → 200.5
20 → 301
30 → 502
50 → 1005
100 → 100010

Asian Handicap & Total Goal Markets

Price
Increment
1.01 → 10000.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£21010
Euro21520
US DollarUS$41520
Hong Kong DollarsHK$25150125
Australian DollarAUD53030
Canadian DollarCAD62530
Danish KronerDKK30150150
Norwegian KronorNOK30150150
Swedish KronaSEK30150150
Singapore DollarSGD63030