#Blockchain API library (Java, v1)

An official Java library for interacting with the Blockchain.info API (Java 1.6 required).

###Getting started

If you prefer building from source:

$ git clone https://github.com/blockchain/api-v1-client-java
$ cd api-v1-client-java
$ mvn install

Note that the above procedures require Maven. If you do not wish to use Maven, please compile the source manually.

The library consists of the following packages:

• info.blockchain.api.blockexplorer (docs) (api/blockchain_api)
• info.blockchain.api.createwallet (docs) (api/create_wallet)
• info.blockchain.api.exchangerates (docs) (api/exchange_rates_api)
• info.blockchain.api.pushtx (docs) (pushtx)
• info.blockchain.api.receive (docs) (api/api_receive)
• info.blockchain.api.statistics (docs) (api/charts_api)
• info.blockchain.api.wallet (docs) (api/blockchain_wallet_api)

###Error handling

All methods may throw exceptions caused by incorrectly passed parameters or other problems. If a call is rejected server-side, the APIException exception will be thrpwn. In case of a network error, the IOException exception will be thrown.

###Connection timeouts

It is possible to set arbitrary connection timeouts.

info.blockchain.api.HttpClient.TIMEOUT_MS = 2000; // time out after 2000 milliseconds

###Request limits and API keys

In order to prevent abuse some API methods require an API key approved with some basic contact information and a description of its intended use. Please request an API key here.

The same API key can be used to bypass the request limiter.