coinbase-java

A java wrapper around the coinbase REST APIs

Dependencies:

• google-gson
• apache httpclient-4.3.1

Supported APIs

• Authentication
• Get current user
• list addresses (page, limit, and query support)
• generate recieve address
• buy
• sell
• list transactions
• get transaction details
• send money
• request money
• resend money request
• cancel money request
• complete money request
• buttons

Usage:

All work is done via the CoinbaseApi class. You can construct an instance of this class one of three ways:

//Constructs an instance of CoinbaseApi using OAuth
CoinbaseApi api = new CoinbaseApi(clientId, clientSecret, redirectUrl);

//Constructs an instance of CoinbaseApi using and api key
CoinbaseApi api = new CoinbaseApi(apiKey);

//Constructs an instance of CoinbaseApi using OAuth, but providing an access token and refresh token up front
CoinbaseApi api = new CoinbaseApi(clientId, clientSecret, redirectUrl, accessToken, refreshToken);

OAuth: If you are using OAuth as your authentication mechanism, you will first need to authenticate. coinbase-java only supports coinbase's new three-legged OAuth and there are no plans to support their old, deprecated two-legged OAuth.

The first thing you need to do is generate an authentication URL. You can do this by calling:

String authUrl = api.generateOAuthUrl();

Then, the user will need to use this url to obtain an authentication code. Once the code is in hand, to authenticate, simply do

//get the auth code using the authUrl
if (api.authenticate(code)) {
    //auth success
} else {
    //auth failed
}

For information on coinbase's three-legged auth, see here.

HttpClient vs. HttpURLConnection By default, coinbase-java uses apache's HttpClient libraries for connections. If you are using a service such as Google App Engine that doesn't support these libraries or handles secure connections on its own, you can choose to use HttpURLConnection instead by doing

api.allowSecure(false);