
- •Getting Started with API-NG
- •Application Keys
- •API-NG Login
- •Non-Interactive (bot) login
- •Certificate Generation With XCA
- •Interactive Login from a Desktop Application
- •Interactive Login - API Endpoint
- •Login FAQs
- •Keep Alive
- •Logout
- •API-NG - Visualiser
- •Example Requests
- •Market Data Request Limits
- •Understanding Market Navigation
- •API 6.0 > API-NG Operations Comparison Table
- •API-NG Reference Guide
- •Betting API
- •Betfair Starting Price Betting (BSP)
- •Betting on Australian Events
- •Betting On Italian Exchange
- •Navigation Data For Applications
- •Betting Operations
- •listCompetitions
- •listCountries
- •listCurrentOrders
- •listClearedOrders
- •listClearedOrders - Roll-up Fields Available
- •listEvents
- •listEventTypes
- •listMarketBook
- •listMarketCatalogue
- •listMarketProfitAndLoss
- •listMarketTypes
- •listTimeRanges
- •listVenues
- •placeOrders
- •Italian Exchange Specific Bet Rules
- •cancelOrders
- •replaceOrders
- •updateOrders
- •Betting Exceptions
- •Betting Enums
- •Betting Type Definitions
- •Accounts API
- •Accounts Operations
- •createDeveloperAppKeys
- •getAccountDetails
- •getAccountFunds
- •getDeveloperAppKeys
- •getAccountStatement
- •listCurrencyRates
- •transferFunds
- •Account Operations (Vendor API)
- •activateApplicationSubscription
- •cancelApplicationSubscription
- •getApplicationSubscriptionHistory
- •getApplicationSubscriptionToken
- •getVendorClientId
- •listAccountSubscriptionTokens
- •listApplicationSubscriptionTokens
- •updateApplicationSubscription
- •Accounts Exceptions
- •Accounts Enums
- •Accounts TypeDefinitions
- •Heartbeat API
- •Vendor Services in API-NG
- •Interface Definition Documents
- •Additional Information
- •Betfair Price Increments
- •Currency Parameters
- •Racecourse Abbreviations
- •Runner Metadata Description
- •Time Zones
- •Common Error Codes
- •Sample Code
- •Excel & VBA Sample
- •Java
- •Javascript
- •Python

listVenues
List< VenueResult > listVenues ( MarketFilter filter ,Stringlocale ) throws APINGException
Returns a list of Venues (i.e. Cheltenham, Ascot) associated with the markets selected by the MarketFilter. Currently, only Horse Racing markets are associated with a Venue.
Parameter name |
Type |
Required |
Description |
filter |
MarketFilter |
|
The filter to select |
|
|
|
desired markets. All |
|
|
|
markets that match the |
|
|
|
criteria in the filter are |
|
|
|
selected. |
locale |
String |
|
The language used for |
|
|
|
the response. If not |
|
|
|
specified, the default is |
|
|
|
returned. |
Return type |
Description |
List< VenueResult > |
output data |
Throws |
Description |
APINGException |
Generic exception that is thrown if this operation |
|
fails for any reason. |
Since 1.0.0 |
|
placeOrders
Operation

placeOrders
PlaceExecutionReport placeOrders ( StringmarketId , List< PlaceInstruction >instructions ,Stringc ustomerRef ) 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. |
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. |
Return type |
Description |
PlaceExecutionReport |
|
Throws |
Description |
APINGException |
Generic exception that is thrown if this operation |
|
fails for any reason. |
Since 1.0.0 |
|
Italian Exchange Specific Bet Rules
There are several additional regulatory rules which apply specifically and only to accounts betting on the Italian Exchange (https://www.betfair.it/exchange):
1.The stake for each back offer is a minimum of 200 Euro Cents and can only be incremented in multiples of 50 Euro Cents.
2.Any lay offers placed by the customer, must be placed in such a way as to ensure that the stake for any