Market

    

Description

Binance4j-market is a Java connector for the market endpoints of the Binance REST API.

Installation

Maven

pom.xml

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

Gradle

build.gradle

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

Dependencies

• binance4j-core : The core of every binance4j artifact
• Lombok : Prevent boilerplate code.
• OkHttp : HTTP && Websocket clients
• Retrofit : Map API endpoints with annotations.
• Jackson : Payload deserialization
• Apache Common Codecs : Encode/decode urls

Test connectivity

   

Sync

MarketDataClient client = new MarketDataClient(key, secret);

try{
    client.ping().execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

client.ping().then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

client.ping().then(new ApiCallback<Void>() {
    @Override
    public void onResponse() {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Get server time

    

Sync

MarketDataClient client = new MarketDataClient(key, secret);

try{
    ServerTimeResponse response = client.getServerTime().execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

client.getServerTime().then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

client.getServerTime().then(new ApiCallback<ServerTimeResponse>() {
    @Override
    public void onResponse(ServerTimeResponse response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Get exchange info

     

All symbols

Sync

MarketDataClient client = new MarketDataClient(key, secret);

try{
    ExchangeInfo response = client.getExchangeInfo().execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

client.getExchangeInfo().then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

client.getExchangeInfo().then(new ApiCallback<ExchangeInfo>() {
    @Override
    public void onResponse(ExchangeInfo response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

One symbol

Sync

MarketDataClient client = new MarketDataClient(key, secret);

ExchangeInfoRequest request = new ExchangeInfoRequest("BNBBTC");

try{
    ExchangeInfo response = client.getExchangeInfo(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

ExchangeInfoRequest request = new ExchangeInfoRequest("BNBBTC");

client.getExchangeInfo(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

ExchangeInfoRequest request = new ExchangeInfoRequest("BNBBTC");

client.getExchangeInfo().then(new ApiCallback<ExchangeInfo>() {
    @Override
    public void onResponse(ExchangeInfo response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Multiple symbols

Sync

MarketDataClient client = new MarketDataClient(key, secret);

ExchangeInfoRequest request = new ExchangeInfoRequest(List.of("BNBBTC","BTCEUR","SHIBEUR"));

try{
    ExchangeInfo response = client.getExchangeInfo(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

ExchangeInfoRequest request = new ExchangeInfoRequest(List.of("BNBBTC","BTCEUR","SHIBEUR"));

client.getExchangeInfo(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

ExchangeInfoRequest request = new ExchangeInfoRequest(List.of("BNBBTC","BTCEUR","SHIBEUR"));

client.getExchangeInfo().then(new ApiCallback<ExchangeInfo>() {
    @Override
    public void onResponse(ExchangeInfo response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Get a symbol's order book

     

The term order book refers to an electronic list of buy and sell orders for a specific security or financial instrument organized by price level. An order book lists the number of shares being bid on or offered at each price point, or market depth. It also identifies the market participants behind the buy and sell orders, though some choose to remain anonymous. These lists help traders and also improve market transparency because they provide valuable trading information.

Investopedia

Default request (limit: 100)

Sync

MarketDataClient client = new MarketDataClient(key, secret);

OrderBookRequest request = new OrderBookRequest("BNBBTC");

try{
    OrderBook response = client.getOrderBook(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

OrderBookRequest request = new OrderBookRequest("BNBBTC");

client.getOrderBook(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

OrderBookRequest request = new OrderBookRequest("BNBBTC");

client.getOrderBook().then(new ApiCallback<OrderBook>() {
    @Override
    public void onResponse(OrderBook response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Request with limit

Sync

MarketDataClient client = new MarketDataClient(key, secret);

OrderBookRequest request = new OrderBookRequest("BNBBTC", 500);

try{
    OrderBook response = client.getOrderBook(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

OrderBookRequest request = new OrderBookRequest("BNBBTC", 500);

client.getOrderBook(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

OrderBookRequest request = new OrderBookRequest("BNBBTC", 500);

client.getOrderBook().then(new ApiCallback<OrderBook>() {
    @Override
    public void onResponse(OrderBook response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

note

The limit will determine the request weight

danger

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

Get recent trades

     

Default request (limit: 500)

Sync

MarketDataClient client = new MarketDataClient(key, secret);

TradesRequest request = new TradesRequest("BNBBTC");

try{
    List<TradeHistoryItem> response = client.getTrades(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

TradesRequest request = new TradesRequest("BNBBTC");

client.getTrades(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

TradesRequest request = new TradesRequest("BNBBTC");

client.getTrades().then(new ApiCallback<List<TradeHistoryItem>>() {
    @Override
    public void onResponse(List<TradeHistoryItem> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Request with max limit

Sync

MarketDataClient client = new MarketDataClient(key, secret);

TradesRequest request = new TradesRequest("BNBBTC", 1000);

try{
    List<TradeHistoryItem> response = client.getTrades(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

TradesRequest request = new TradesRequest("BNBBTC", 1000);

client.getTrades(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

TradesRequest request = new TradesRequest("BNBBTC", 1000);

client.getTrades().then(new ApiCallback<List<TradeHistoryItem>>() {
    @Override
    public void onResponse(List<TradeHistoryItem> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Get historical trades

     

Default request (limit: 500)

Sync

MarketDataClient client = new MarketDataClient(key, secret);

HistoricalTradesRequest request = new HistoricalTradesRequest("BNBBTC");

try{
    List<TradeHistoryItem> response = client.getHistoricalTrades(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

HistoricalTradesRequest request = new HistoricalTradesRequest("BNBBTC");

client.getHistoricalTrades(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

HistoricalTradesRequest request = new HistoricalTradesRequest("BNBBTC");

client.getHistoricalTrades().then(new ApiCallback<List<TradeHistoryItem>>() {
    @Override
    public void onResponse(List<TradeHistoryItem> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Request with max limit

Sync

MarketDataClient client = new MarketDataClient(key, secret);

HistoricalTradesRequest request = new HistoricalTradesRequest("BNBBTC", 1000);

try{
    List<TradeHistoryItem> response = client.getHistoricalTrades(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

HistoricalTradesRequest request = new HistoricalTradesRequest("BNBBTC", 1000);

client.getHistoricalTrades(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

HistoricalTradesRequest request = new HistoricalTradesRequest("BNBBTC", 1000);

client.getHistoricalTrades().then(new ApiCallback<List<TradeHistoryItem>>() {
    @Override
    public void onResponse(List<TradeHistoryItem> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

From specific trade id

Sync

MarketDataClient client = new MarketDataClient(key, secret);

HistoricalTradesRequest request = new HistoricalTradesRequest("BNBBTC", 1000, 654830L);

try{
    List<TradeHistoryItem> response = client.getHistoricalTrades(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

HistoricalTradesRequest request = new HistoricalTradesRequest("BNBBTC", 1000, 654830L);

client.getHistoricalTrades(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

HistoricalTradesRequest request = new HistoricalTradesRequest("BNBBTC", 1000, 654830L);

client.getHistoricalTrades().then(new ApiCallback<List<TradeHistoryItem>>() {
    @Override
    public void onResponse(List<TradeHistoryItem> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Get compressed/aggregate trades List

     

Default request (limit: 500)

Sync

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC");

try{
    List<AggTrade> response = client.getAggTrades(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC");

client.getAggTrades(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC");

client.getAggTrades().then(new ApiCallback<List<AggTrade>>() {
    @Override
    public void onResponse(List<AggTrade> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Request with max limit

Sync

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC", 1000);

try{
    List<AggTrade> response = client.getAggTrades(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC", 1000);

client.getAggTrades(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC", 1000);

client.getAggTrades().then(new ApiCallback<List<AggTrade>>() {
    @Override
    public void onResponse(List<AggTrade> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

From specific id

Sync

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC", "654830");

try{
    List<AggTrade> response = client.getAggTrades(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC", "654830");

client.getAggTrades(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC", "654830");

client.getAggTrades().then(new ApiCallback<List<AggTrade>>() {
    @Override
    public void onResponse(List<AggTrade> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

With start time and end time

Sync

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC", 1640769296641L, 1651769296641L);

try{
    List<AggTrade> response = client.getAggTrades(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC", 1640769296641L, 1651769296641L);

client.getAggTrades(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

AggTradeRequest request = new AggTradeRequest("BNBBTC", 1640769296641L, 1651769296641L);

client.getAggTrades().then(new ApiCallback<List<AggTrade>>() {
    @Override
    public void onResponse(List<AggTrade> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Get Klines / candles

     

With CandlestickInterval

Sync

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", CandlestickInterval.FIVE_MINUTES);

try{
    List<CandlestickBar> response = client.getKlines(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", CandlestickInterval.FIVE_MINUTES);

client.getKlines(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", CandlestickInterval.FIVE_MINUTES);

client.getKlines().then(new ApiCallback<List<CandlestickBar>>() {
    @Override
    public void onResponse(List<CandlestickBar> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

With String interval

Sync

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", "5m");

try{
    List<CandlestickBar> response = client.getKlines(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", "5m");

client.getKlines(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", "5m");

client.getKlines().then(new ApiCallback<List<CandlestickBar>>() {
    @Override
    public void onResponse(List<CandlestickBar> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

With a limit

Sync

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", "5m", 1000);

try{
    List<CandlestickBar> response = client.getKlines(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", "5m", 1000);

client.getKlines(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", "5m", 1000);

client.getKlines().then(new ApiCallback<List<CandlestickBar>>() {
    @Override
    public void onResponse(List<CandlestickBar> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

With start time and end time

Sync

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", CandlestickInterval.FIVE_MINUTES, 1640769296641L, 1651769296641L);

try{
    List<CandlestickBar> response = client.getKlines(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", CandlestickInterval.FIVE_MINUTES, 1640769296641L, 1651769296641L);

client.getKlines(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

KlinesRequest request = new KlinesRequest("BNBBTC", CandlestickInterval.FIVE_MINUTES, 1640769296641L, 1651769296641L);

client.getKlines().then(new ApiCallback<List<CandlestickBar>>() {
    @Override
    public void onResponse(List<CandlestickBar> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

note

Default limit is 500, max is 1000.

caution

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

Get average price

     

Sync

MarketDataClient client = new MarketDataClient(key, secret);

AveragePriceRequest request = new AveragePriceRequest("BNBBTC");

try{
    AveragePrice response = client.getAveragePrice(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

AveragePriceRequest request = new AveragePriceRequest("BNBBTC");

client.getAveragePrice(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

AveragePriceRequest request = new AveragePriceRequest("BNBBTC");

client.getAveragePrice().then(new ApiCallback<AveragePrice>() {
    @Override
    public void onResponse(AveragePrice response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Get 24h ticker statistics

     

One symbol

Sync

MarketDataClient client = new MarketDataClient(key, secret);

TickerStatisticsRequest request = new TickerStatisticsRequest("BNBBTC");

try{
    TickerStatistics response = client.get24hTickerStatistics(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

TickerStatisticsRequest request = new TickerStatisticsRequest("BNBBTC");

client.get24hTickerStatistics(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

TickerStatisticsRequest request = new TickerStatisticsRequest("BNBBTC");

client.get24hTickerStatistics().then(new ApiCallback<TickerStatistics>() {
    @Override
    public void onResponse(TickerStatistics response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

All symbols

Sync

MarketDataClient client = new MarketDataClient(key, secret);

try{
    List<TickerStatistics> response = client.get24hTickerStatistics().execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

client.get24hTickerStatistics().then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

client.get24hTickerStatistics().then(new ApiCallback<List<TickerStatistics>>() {
    @Override
    public void onResponse(List<TickerStatistics> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Specific symbols

Sync

MarketDataClient client = new MarketDataClient(key, secret);

TickersStatisticsRequest request = new TickersStatisticsRequest(List.of("BNBBTC","BNBBUSD"));

try{
    List<TickerStatistics> response = client.get24hTickerStatistics(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

TickersStatisticsRequest request = new TickersStatisticsRequest(List.of("BNBBTC","BNBBUSD"));

client.get24hTickerStatistics(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

TickersStatisticsRequest request = new TickersStatisticsRequest(List.of("BNBBTC","BNBBUSD"));

client.get24hTickerStatistics().then(new ApiCallback<List<TickerStatistics>>() {
    @Override
    public void onResponse(List<TickerStatistics> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

note

Note the difference between TickerStatisticsRequest and TickersStatisticsRequest. The first is for one or all symbols, the other is for specific symbols.

Get price ticker

     

One symbol

Sync

MarketDataClient client = new MarketDataClient(key, secret);

PriceTickerRequest request = new PriceTickerRequest("BNBBTC");

try{
    PriceTicker response = client.getTicker(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

PriceTickerRequest request = new PriceTickerRequest("BNBBTC");

client.getTicker(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

PriceTickerRequest request = new PriceTickerRequest("BNBBTC");

client.getTicker().then(new ApiCallback<PriceTicker>() {
    @Override
    public void onResponse(PriceTicker response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

All symbols

Sync

MarketDataClient client = new MarketDataClient(key, secret);

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

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

client.getTicker().then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

client.getTicker().then(new ApiCallback<List<PriceTicker>>() {
    @Override
    public void onResponse(List<PriceTicker> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Specific symbols

Sync

MarketDataClient client = new MarketDataClient(key, secret);

PriceTickersRequest request = new PriceTickersRequest(List.of("BNBBTC","BNBBUSD"));

try{
    List<PriceTicker> response = client.getTicker(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

PriceTickersRequest request = new PriceTickersRequest(List.of("BNBBTC","BNBBUSD"));

client.getTicker(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

PriceTickersRequest request = new PriceTickersRequest(List.of("BNBBTC","BNBBUSD"));

client.getTicker().then(new ApiCallback<List<PriceTicker>>() {
    @Override
    public void onResponse(List<PriceTicker> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

note

Note the difference between PriceTickerRequest and PriceTickersRequest. The first is for one or all symbols, the other is for specific symbols.

Get order book ticker

     

One symbol

Sync

MarketDataClient client = new MarketDataClient(key, secret);

BookTickerRequest request = new BookTickerRequest("BNBBTC");

try{
    BookTicker response = client.getBookTicker(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

BookTickerRequest request = new BookTickerRequest("BNBBTC");

client.getBookTicker(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

BookTickerRequest request = new BookTickerRequest("BNBBTC");

client.getBookTicker().then(new ApiCallback<BookTicker>() {
    @Override
    public void onResponse(BookTicker response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

All symbols

Sync

MarketDataClient client = new MarketDataClient(key, secret);

try{
    List<BookTicker> response = client.getBookTicker().execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

client.getBookTicker().then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

client.getBookTicker().then(new ApiCallback<List<BookTicker>>() {
    @Override
    public void onResponse(List<BookTicker> response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

Specific symbols

Sync

MarketDataClient client = new MarketDataClient(key, secret);

BookTickersRequest request = new BookTickersRequest(List.of("BNBBTC","BNBBUSD"));

try{
    BookTicker response = client.getBookTicker(request).execute();
}catch(ApiException e){ 
//...
}

Async (lambda)

MarketDataClient client = new MarketDataClient(key, secret);

BookTickersRequest request = new BookTickersRequest(List.of("BNBBTC","BNBBUSD"));

client.getBookTicker(request).then(response->{
  //...
});

Async (ApiCallback)

MarketDataClient client = new MarketDataClient(key, secret);

BookTickersRequest request = new BookTickersRequest(List.of("BNBBTC","BNBBUSD"));

client.getBookTicker().then(new ApiCallback<BookTicker>() {
    @Override
    public void onResponse(BookTicker response) {
        //...
    }

    @Override
    public void onFailure(ApiException exception) {
        //...
    }
});

note

Note the difference between BookTickerRequest and BookTickersRequest. The first is for one or all symbols, the other is for specific symbols.