Betfair Exchange API-NG Java Client

A Java Client to help the implementation of applications and bots that interact with the Betfair Exchange API-NG described here.

Getting started

Building from Source

To generate and publish in the project directory the jar of the library, run the jar and publish gradle tasks.

./gradlew clean jar publish

A build.sh script is also provided.

Build and use the BetfairClient

The BetfairClients class provides factory methods to facilitate the creation of the BetfairClient.

A default implementation of the BetfairClient can be created with the following code:

BetfairClient betfairClient = BetfairClients.createDefault();

Building an instance of the BetfairClient in this way will imply the creation of a it.nicolagiacchetta.betfair.utils.HttpClient and of a com.fasterxml.jackson.databind.ObjectMapper. For this reason, it is recommended that the same instance of the BetfairClient is reused for multiple request executions, ideally throughout all the application lifecycle.

It is also possible to retrieve via the BetfairClients.custom() method a BetfairClientBuilder. Although permitted, it is highly discouraged to provide custom implementations of the it.nicolagiacchetta.betfair.utils.HttpClient and a com.fasterxml.jackson.databind.ObjectMapper. In particular before reusing your application com.fasterxml.jackson.databind.ObjectMapper, be sure that its custom configuration does not break the compatibility with the JSON format expected by the Betfair Exchange API-NG.

When an instance of the BetfairClient is no longer needed and is about to go out of scope, it must be explictly shut down by calling the BetfairClient#close() method.

Examples

Some examples showing how to use the BetfairClient can be found here.

To run the examples, substitute the values of following variables defined at the top of the main method with your real Betfair credentials:

String username = "YOUR_BETFAIR_USERNAME";
String password = "YOUR_BETFAIR_PASSWORD";
String appKey = "YOUR_BETFAIR_APPKEY";

Supported APIs

The project currently supports the following operations:

Login & Session Management described here
List Events (exchange/betting/rest/v1.0/listEvents/)
List Event Types (exchange/betting/rest/v1.0/listEventTypes/)
List Market Catalogue (exchange/betting/rest/v1.0/listMarketCatalogue/)