Market

  

Installation

Maven

pom.xml

<dependency>
	<groupId>{{groupId}}</groupId>
	<artifactId>{{artifactId}}</artifactId>
	<version>{{version}}</version>
</dependency>

Gradle

build.gradle

implementation '{{groupId}}:{{artifactId}}:{{version}}'

Client instantiation

MarketDataClient client = new MarketDataClient(key, secret);

Features

Test connectivity

client.ping().sync();

Get server time

Sync

try{
    ServerTimeRespons res =  client.getServerTime().sync();
}catch(ApiException e){ 
//...
}

Async

client.getServerTime().async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Get exchange info

All symbols

Sync

try{
    ExchangeInfo res =  client.getExchangeInfo().sync();
}catch(ApiException e){ 
//...
}

Async

client.getExchangeInfo().async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

One symbol

Sync

try{
    ExchangeInfo res =  client.getExchangeInfo(new ExchangeInfoParams(symbol)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getExchangeInfo(new ExchangeInfoParams(symbol)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Multiple symbols

Sync

try{
    ExchangeInfo res =  client.getExchangeInfo(new ExchangeInfoParams(symbols[])).sync();
}catch(ApiException e){ 
//...
}

Async

client.getExchangeInfo(new ExchangeInfoParams(symbols[])).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Get a symbol's order book

One symbol

Sync

try{
    OrderBook res =  client.getOrderBook(new OrderBookParams(symbol)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getOrderBook(new OrderBookParams(symbol)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

With limit (Enum)

Sync

try{
    OrderBook res =  client.getOrderBook(new OrderBookParams(symbol,OrderBookLimit.LIMIT_10)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getOrderBook(new OrderBookParams(symbol,OrderBookLimit.LIMIT_10)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

With limit (String)

Sync

try{
    OrderBook res =  client.getOrderBook(new OrderBookParams(symbol,"10")).sync();
}catch(ApiException e){ 
//...
}

Async

client.getOrderBook(new OrderBookParams(symbol,"10")).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

caution

The String value must match one of the OrderBookLimit values or the request will fail

Get recent trades

One symbol

Sync

try{
    List<Trade> res =  client.getTrades(new TradesParams(symbol)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getTrades(new TradesParams(symbol)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

With limit

Sync

try{
    List<Trade> res =  client.getTrades(new TradesParams(symbol,10)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getTrades(new TradesParams(symbol,10)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Get historical trades

Default

Sync

try{
    List<Trade> res =  client.getHistoricalTrades(new TradesParams(symbol)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getHistoricalTrades(new TradesParams(symbol)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

With limit

Sync

try{
    List<Trade> res =  client.getHistoricalTrades(new TradesParams(symbol,10)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getHistoricalTrades(new TradesParams(symbol,10)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Get compressed/aggregate trades List

Default

Sync

try{
    List<AggTrade> res =  client.getAggTrades(new AggTradeParams(symbol)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getAggTrades(new AggTradeParams(symbol)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Framed

Sync

try{
    List<AggTrade> res =  client.getAggTrades(new AggTradeParams(symbol), new TimeFrame(startTime, endTime, limit)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getAggTrades(new AggTradeParams(symbol), new TimeFrame(startTime, endTime, limit)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Get Klines / candles

Enum interval

Sync

try{
    List<Candle> res =  client.getKlines(new KlinesParams(symbol, CandlestickInterval.ONE_MINUTE)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getKlines(new KlinesParams(symbol, CandlestickInterval.ONE_MINUTE)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

String interval

Sync

try{
    List<Candle> res =  client.getKlines(new KlinesParams(symbol, "1m")).sync();
}catch(ApiException e){ 
//...
}

Async

client.getKlines(new KlinesParams(symbol, "1m")).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

caution

The String interval must correspond to one of the CandlestickInterval else the request will throw an ApiException

Get average price

Sync

try{
    AveragePrice res =  client.getAveragePrice(new AveragePriceParams(symbol)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getAveragePrice(new AveragePriceParams(symbol)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Get 24h ticker statistics

Sync

try{
    TickerStatistics res =  client.get24hTickerStatistics(new TickerStatisticsParams(symbol)).sync();
}catch(ApiException e){ 
//...
}

Async

client.get24hTickerStatistics(new TickerStatisticsParams(symbol)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

All symbols

Sync

try{
    List<TickersStatistics> res =  client.get24hTickerStatistics().sync();
}catch(ApiException e){ 
//...
}

Async

client.get24hTickerStatistics().async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Multiple symbols

Sync

try{
    List<TickersStatistics> res =  client.get24hTickerStatistics(new TickerStatisticsParams(symbols[])).sync();
}catch(ApiException e){ 
//...
}

Async

client.get24hTickerStatistics(new TickerStatisticsParams(symbols[])).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Get price ticker

Sync

try{
    PriceTicker res =  client.getTicker(new PriceTickerParams(symbol)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getTicker(new PriceTickerParams(symbol)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

All symbols

Sync

try{
    List<PriceTicker> res =  client.getTicker().sync();
}catch(ApiException e){ 
//...
}

Async

client.getTicker().async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Multiple symbols

Sync

try{
    List<PriceTicker> res =  client.getTicker(new PriceTickersParams(symbols[])).sync();
}catch(ApiException e){ 
//...
}

Async

client.getTicker(new PriceTickersParams(symbols[])).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

Get order book ticker

Default

Sync

try{
    OrderBook res =  client.getOrderBook(new OrderBookParams(symbol)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getOrderBook(new OrderBookParams(symbol)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

With limit (Enum)

Sync

try{
    OrderBook res =  client.getOrderBook(new OrderBookParams(symbol, OrderBookLimit.LIMIT_10)).sync();
}catch(ApiException e){ 
//...
}

Async

client.getOrderBook(new OrderBookParams(symbol, OrderBookLimit.LIMIT_10)).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

With limit (String)

Sync

try{
    OrderBook res =  client.getOrderBook(new OrderBookParams(symbol, "10")).sync();
}catch(ApiException e){ 
//...
}

Async

client.getOrderBook(new OrderBookParams(symbol, "10")).async((response, exception) -> {
    if(exception == null){
        //...
    }else{
        //...
    }
});

caution

The String value must match one of the OrderBookLimit values or the request will fail