feat: implement historical klines api (#1)

Author: czetsuya

src/main/java/com/binance/api/client/BinanceApiAsyncRestClient.java

@@ -122,6 +122,9 @@ public interface BinanceApiAsyncRestClient {
    */
   void getCandlestickBars(String symbol, CandlestickInterval interval, Integer limit, Long startTime, Long endTime, BinanceApiCallback<List<Candlestick>> callback);
 
+  void getCandlestickHistoryBars(String symbol, CandlestickInterval interval, Integer limit, Long startTime,
+      Long endTime, BinanceApiCallback<List<Candlestick>> callback);
+
   /**
    * Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.
    *

src/main/java/com/binance/api/client/BinanceApiRestClient.java

@@ -105,6 +105,9 @@ public interface BinanceApiRestClient {
    */
   List<Candlestick> getCandlestickBars(String symbol, CandlestickInterval interval, Integer limit, Long startTime, Long endTime);
 
+  List<Candlestick> getCandlestickHistoryBars(String symbol, CandlestickInterval interval, Integer limit,
+      Long startTime, Long endTime);
+
   /**
    * Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.
    *

src/main/java/com/binance/api/client/impl/BinanceApiAsyncRestClientImpl.java

@@ -101,6 +101,12 @@ public void getCandlestickBars(String symbol, CandlestickInterval interval, Inte
     binanceApiService.getCandlestickBars(symbol, interval.getIntervalId(), limit, startTime, endTime).enqueue(new BinanceApiCallbackAdapter<>(callback));
   }
 
+  @Override
+  public void getCandlestickHistoryBars(String symbol, CandlestickInterval interval, Integer limit, Long startTime,
+      Long endTime, BinanceApiCallback<List<Candlestick>> callback) {
+    binanceApiService.getCandlestickBars(symbol, interval.getIntervalId(), limit, startTime, endTime).enqueue(new BinanceApiCallbackAdapter<>(callback));
+  }
+
   @Override
   public void getCandlestickBars(String symbol, CandlestickInterval interval, BinanceApiCallback<List<Candlestick>> callback) {
     getCandlestickBars(symbol, interval, null, null, null, callback);

src/main/java/com/binance/api/client/impl/BinanceApiRestClientImpl.java

@@ -84,6 +84,13 @@ public List<Candlestick> getCandlestickBars(String symbol, CandlestickInterval i
 				binanceApiService.getCandlestickBars(symbol, interval.getIntervalId(), limit, startTime, endTime));
 	}
 
+	@Override
+	public List<Candlestick> getCandlestickHistoryBars(String symbol, CandlestickInterval interval, Integer limit,
+			Long startTime, Long endTime) {
+		return executeSync(
+				binanceApiService.getCandlestickHistoryBars(symbol, interval.getIntervalId(), limit, startTime, endTime));
+	}
+
 	@Override
 	public List<Candlestick> getCandlestickBars(String symbol, CandlestickInterval interval) {
 		return getCandlestickBars(symbol, interval, null, null, null);

src/main/java/com/binance/api/client/impl/BinanceApiService.java

@@ -57,6 +57,11 @@ Call<List<AggTrade>> getAggTrades(@Query("symbol") String symbol, @Query("fromId
     Call<List<Candlestick>> getCandlestickBars(@Query("symbol") String symbol, @Query("interval") String interval, @Query("limit") Integer limit,
                                                @Query("startTime") Long startTime, @Query("endTime") Long endTime);
 
+    @GET("/api/v3/uiKlines")
+    Call<List<Candlestick>> getCandlestickHistoryBars(@Query("symbol") String symbol,
+        @Query("interval") String interval, @Query("limit") Integer limit,
+        @Query("startTime") Long startTime, @Query("endTime") Long endTime);
+
     @GET("/api/v1/ticker/24hr")
     Call<TickerStatistics> get24HrPriceStatistics(@Query("symbol") String symbol);
 

src/test/java/com/binance/api/examples/UIKLinesExample.java

@@ -0,0 +1,27 @@
+package com.binance.api.examples;
+
+import com.binance.api.client.BinanceApiClientFactory;
+import com.binance.api.client.BinanceApiRestClient;
+import com.binance.api.client.domain.market.Candlestick;
+import com.binance.api.client.domain.market.CandlestickInterval;
+import java.util.List;
+
+public class UIKLinesExample {
+
+  public static void main(String[] args) {
+    new UIKLinesExample();
+  }
+
+  public UIKLinesExample() {
+    BinanceApiClientFactory factory = BinanceApiClientFactory.newInstance();
+    BinanceApiRestClient restClient = factory.newRestClient();
+
+    List<Candlestick> result = restClient.getCandlestickHistoryBars("BTCUSDT", CandlestickInterval.FIVE_MINUTES, 168,
+        null, null);
+
+    System.out.println(result.size());
+
+    result.stream()
+        .forEach(System.out::println);
+  }
+}