jansoren / bittrex-java-client Goto Github PK

View Code? Open in Web Editor NEW

This project forked from forgemo/bittrex-java-client

0.0 2.0 0.0 191 KB

Java client for the bittrex.com v1.1 API

License: MIT License

Java 100.00%

bittrex-java-client's Introduction

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();