A java wrapper around the coinbase REST 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
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);