bitso-java

Bitso's official Java wrapper to interact with the Bitso REST API v3.

Installation

You can add this library as a dependency to your Maven or Gradle project through JitPack

Maven projects

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.bitsoex</groupId>
    <artifactId>bitso-java</artifactId>
    <version>4.1.0</version>
</dependency>

Using gradle and Android Studio

On Android Studio find build.gradle file Gradle Scripts -> build.gradle(Project: <your_app_name>)

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

On Android Studio find build.gradle file Gradle Scripts -> build.gradle(Module: app). Add gradle dependency for bitso-java api on the dependencies block.

dependencies {
    implementation 'com.android.support:appcompat-v7:24.2.1'
    ...
    implementation 'com.github.bitsoex:bitso-java:4.1.0'
}

Usage

HMAC Authentication (for accessing your own account)

Start by enabling an API Key on your account

Next, build an instance of the client by passing your API Key, and Secret to a Bitso object.

import com.bitso.Bitso;

Bitso bitso = new Bitso(System.getenv("BITSO_API_KEY"), System.getenv("BITSO_API_SECRET"));

Notice here that we did not hard code the API keys into our codebase, but set them in environment variables instead. This is just one example, but keeping your credentials separate from your code base is a good security practice.

Print all your balances

BitsoBalance bitsoBalance = bitso.getAccountBalance();
HashMap<String, BitsoBalance.Balance> balances = bitsoBalance.getBalances();
System.out.println(balances.get("mxn"));
System.out.println(balances.get("eth"));
System.out.println(balances.get("btc"));
System.out.println(balances.get("xrp"));
System.out.println(balances.get("bch"));

Print Available books

BookInfo[] availableBooks = bitso.getAvailableBooks();
for (BookInfo bookInfo : availableBooks) {
    System.out.println(bookInfo);
}

Print tickers

BitsoTicker[] tickers = bitso.getTicker();
for (Ticker ticker : tickers) {
    System.out.println(ticker);
}

Get user account status

BitsoAccountStatus bitsoAccountStatus = bitso.getAccountStatus();
System.out.println(bitsoAccountStatus);

Get user fees

BitsoFee bitsoFee = bitso.getFees();

HashMap<String, Fee> tradeFees = bitsoFee.getTradeFees();
System.out.println(tradeFees.get("eth_mxn"));
System.out.println(tradeFees.get("btc_mxn"));
System.out.println(tradeFees.get("xrp_mxn"));
System.out.println(tradeFees.get("bch_btc"));
System.out.println(tradeFees.get("xrp_btc"));
System.out.println(tradeFees.get("eth_btc"));

HashMap<String, String> withdrawalFees = bitsoFee.getWithdrawalFees();
System.out.println("BTC fee: " + withdrawalFees.get("btc"));
System.out.println("ETH fee: " + withdrawalFees.get("eth"));

Iterate over all user operations

BitsoOperation[] defaultLedger = bitso.getLedger("");
for (BitsoOperation bitsoOperation : defaultLedger) {
    System.out.println(bitsoOperation);
}

Iterate over particular user ledger operation

String[] operations = { "trades", "fees", "fundings", "withdrawals" };
for (String operationType : operations) {
    BitsoOperation[] specificLedger = bitso.getLedger(operationType);
    for (BitsoOperation bitsoOperation : specificLedger) {
        System.out.println(bitsoOperation);
    }
}

Withdraw 1.00 BTC to the following address: 31yTCKDHTqNXF5eZcsddJDe76BzBh8pVLb

String address = "31yTCKDHTqNXF5eZcsddJDe76BzBh8pVLb";
BigDecimal amount = new BigDecimal("1.00");
boolean saveAccount = false;
BitsoWithdrawal btcWithdrawal = bitso.bitcoinWithdrawal(amount, address, saveAccount);
            
// Save/update an account with an alias
saveAccount = true;
BitsoWithdrawal btcWithdrawalAlias = bitso.bitcoinWithdrawal(amount, address, saveAccount, "new alias");

Withdraw 1.00 ETH to the following address: 0xc83adea9e8fea3797139942a5939b961f67abfb8

String address = "0xc83adea9e8fea3797139942a5939b961f67abfb8";
BigDecimal amount = new BigDecimal("1.00");
boolean saveAccount = false;
BitsoWithdrawal ethWithdrawal = bitso.etherWithdrawal(amount, address, saveAccount);
            
// Save/update an account with an alias
saveAccount = true;
BitsoWithdrawal ethWithdrawalAlias = bitso.etherWithdrawal(amount, address, saveAccount, "new Alias");

Place and cancel orders

String buyOrderId = bitso.placeOrder("btc_mxn", BitsoOrder.SIDE.BUY, BitsoOrder.TYPE.LIMIT,
                    new BigDecimal("0.1"), null, new BigD

...