- •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
TimeRange
TimeRange |
|
|
|
Field name |
Type |
Required |
Description |
from |
Date |
|
from, format: ISO 8601) |
to |
Date |
|
to, format: ISO 8601 |
CurrencyRate
Currency rate |
|
|
|
Field name |
Type |
Required |
Description |
currencyCode |
String |
|
Three letter ISO 4217 |
|
|
|
code |
rate |
double |
|
Exchange rate for the |
|
|
|
currency specified in |
|
|
|
the request |
Heartbeat API
This Heartbeat operation is provided to allow customers to automatically cancel their unmatched bets in the event of their API client/s losing connectivity with the Betfair API.
There are two separate endpoints available for the UK and AUS Exchange:
UK Exchange |
|
Interface |
Endpoint |
JSON-RPC |
https://api.betfair.com/exchange/heartbeat/json-rpc/v1 |
Please note, the Australian Heartbeat service isn't currently available
You can make requests and place bets on Australian markets by accessing the Australian exchange server via the following endpoints.
Australian Exchange
Interface |
Endpoint |
JSON-RPC |
https://api-au.betfair.com/exchange/heartbeat/json-rpc/ |
|
v1 |
Operation summary
HeartbeatReport |
heartbeat ( int preferredTimeoutSeconds ) |
Detailed documentation
Heartbeat
Operations
heartbeat
Events
Type definitions
HeartbeatReport
Enums
ActionPerformed
Exceptions
APINGException
Operations
heartbeat
HeartbeatReport heartbeat ( int preferredTimeoutSeconds ) throws APINGException
This heartbeat operation is provided to help customers have their positions managed automatically in the event of their API clients losing connectivity with the Betfair API. If a heartbeat request is not received within a prescribed time period, then Betfair will attempt to cancel all 'LIMIT' type bets for the given customer on the given exchange. There is no guarantee that this service will result in all bets being cancelled as there are a number of circumstances where bets are unable to be cancelled. Manual intervention is strongly advised in the event of a loss of connectivity to ensure that positions are correctly managed. If this service becomes unavailable for any reason, then your heartbeat will be unregistered automatically to avoid bets being inadvertently cancelled upon resumption of service. you should manage your position manually until the service is resumed. Heartbeat data may also be lost in the unlikely event of nodes failing within the cluster, which may result in your position not being managed until a subsequent heartbeat request is received.
Parameter name |
Type |
Required |
Description |
preferredTimeoutSeco |
int |
|
Maximum period in |
nds |
|
|
seconds that may |
|
|
|
elapse (without a |
subsequent heartbeat request), before a cancellation request is automatically submitted on your behalf. The minimum value is 10, the maximum value permitted is 300. Passing 0 will result in your heartbeat being unregistered (or ignored if you have no current heartbeat registered). You will still get an actionPerformed value returned when passing 0, so this may be used to determine if any action was performed since your last heartbeat, without actually registering a new heartbeat. Passing a negative value will result in an error being returned, INVALID_INPUT_DAT A. Any errors while registering your heartbeat will result in a error being returned, UNEXPECTED_ERRO R. Passing a value that is less than the minimum timeout will result in your heartbeat adopting the minimum timeout. Passing a value that is greater than the maximum timeout will result in your heartbeat adopting the maximum timeout. The minimum and maximum timeouts are subject to change, so your client should utilise the returned actualTimeoutSeconds to set an appropriate
|
frequency for your |
|
subsequent heartbeat |
|
requests. |
Return type |
Description |
HeartbeatReport |
Response from heartbeat operation |
Throws |
Description |
APINGException |
Thrown if the operation fails |
Events
This interface does not define any events.
Type definitions
HeartbeatReport
Response from heartbeat operation |
|
|
|
Field name |
Type |
Required |
Description |
actionPerformed |
ActionPerformed |
|
The action performed |
|
|
|
since your last |
|
|
|
heartbeat request. |
actualTimeoutSeconds |
int |
|
The actual timeout |
|
|
|
applied to your |
|
|
|
heartbeat request, see |
|
|
|
timeout request |
parameter description for details.
Enums
ActionPerformed
Value |
Description |
NONE |
No action was performed since last heartbeat, or |
|
this is the first heartbeat |
CANCELLATION_REQUEST_SUBMITTED |
A request to cancel all unmatched bets was |
|
submitted since last heartbeat |
ALL_BETS_CANCELLED |
All unmatched bets were cancelled since last |
|
heartbeat |
SOME_BETS_NOT_CANCELLED |
Not all unmatched bets were cancelled since last |
|
heartbeat |
CANCELLATION_REQUEST_ERROR |
There was an error requesting cancellation, no |
|
bets have been cancelled |
CANCELLATION_STATUS_UNKNOWN |
There was no response from requesting |
|
cancellation, cancellation status unknown |
Exceptions