!!! This library has been discontinued and archived !!!

bittrex-java-client

Java client for the bittrex.com api. It uses the api version 1.1.

ApiSpec: https://bittrex.com/home/api

Warning! This library is fairly young and not considered stable. Use it with caution ... especially the market api.

Breaking change in 2.0

For greater precision, double values have been replaced by BigDecimal.

Getting started

Building from code with Maven (preferred)

Clone this repository
Execute 'mvn install' to build the library and install it to your local maven repo

Add the following dependency to your projects pom.xml

<dependency>
    <groupId>de.elbatya.cryptocoins</groupId>
    <artifactId>bittrex-client</artifactId>
    <version>2.0</version>
</dependency>

Prebuild binaries via JitPack

Note: Using JitPack is more convenient but less secure. There is no mechanism in place to ensure the authenticity of a downloaded artifact.

Maven via JitPack

Add the JitPack repository to your build file.

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

Add the dependency

<dependency>
    <groupId>com.github.forgemo</groupId>
    <artifactId>bittrex-java-client</artifactId>
    <version>v2.0</version>
</dependency>

Gradle via JitPack

Add the JitPack repository to your build file. Add it in your root build.gradle at the end of repositories:
```
allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
```

Add the dependency

dependencies {
   compile 'com.github.forgemo:bittrex-java-client:v2.0'
}

Others via JitPack

https://jitpack.io/#forgemo/bittrex-java-client/v2.0

Examples

List all markets without credentials

    // Create a BittrexClient
    BittrexClient bittrexClient = new BittrexClient(); 

    // Perform a getMarkets request on the public api
    ApiResult<List<Market>> apiResult = bittrexClient.getPublicApi().getMarkets();
    
    // Unwrap the results
    List<Market> markets = apiResult.unwrap();

List all your open orders using credentials

    // Ceate ApiCredentials with ApiKey and Secret from bittrex.com
    ApiCredentials credentials = new ApiCredentials( 
      "YourApiKeyFromBittrex.com", 
      "YourApiKeySecretFromBittrex.com" 
    ); 
    
    // Create a BittrexClient with the ApiCredentials
    BittrexClient bittrexClient = new BittrexClient(credentials); 

    // Perform a getOpenOrders request on the market api    
    ApiResult<List<OpenOrder>> apiResult = bittrexClient.getMarketApi().getOpenOrders();
    
    // Unwrap the results
    List<OpenOrder> openOrders = apiResult.unwrap();

How to get credentials for the non-public Bittrex api

Create an account at bittrex.com
Enable Two-Factor-Authentication in your account settings
Create an api key with the required permissions in your account settings
Use the api key and secret like shown in the examples
Read https://bittrex.com/home/api for more infos

forgemo/bittrex-java-client

bittrex-java-client

Breaking change in 2.0

Getting started

Building from code with Maven (preferred)

Prebuild binaries via JitPack

Maven via JitPack

Gradle via JitPack

Others via JitPack

Examples

List all markets without credentials

List all your open orders using credentials

How to get credentials for the non-public Bittrex api

Implementation Status

Public Api

Market Api (Credentials required)

Account Api (Credentials required)

Stability

Do you like this library?

Donate Bitcoins to 18rdYGVpG5BZ7EFRie65E9pfvMSE47EEfV

Donate Ether to 0x10dcd290c3aa2393c005E981DED566C8fB75C182