feat[API-1816]: add market data api add start_time and end_time for bars/list

AI-Assisted: true

Author: immture

pom.xml

@@ -21,7 +21,7 @@
     <groupId>com.webull.openapi</groupId>
     <artifactId>webull-openapi-java-sdk-parent</artifactId>
     <packaging>pom</packaging>
-    <version>2.0.3</version>
+    <version>2.0.4</version>
 
     <name>webull-openapi-java-sdk-parent</name>
     <url>https://github.com/webull-inc/webull-openapi-java-sdk/</url>

webull-openapi-java-sdk-samples/pom.xml

@@ -19,7 +19,7 @@
     <parent>
         <groupId>com.webull.openapi</groupId>
         <artifactId>webull-openapi-java-sdk-parent</artifactId>
-        <version>2.0.3</version>
+        <version>2.0.4</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 

webull-openapi-java-sdk-samples/src/main/java/com/webull/openapi/samples/data/DataClient.java

@@ -72,8 +72,16 @@ public static void main(String[] args) {
         cryptoInstruments = dataClient.getCryptoInstrument(instrumentQueryParam);
         logger.info("Crypto instruments: {}", cryptoInstruments);
 
-        // get crypto bars
-        List<NBar> cryptoBars = dataClient.getCryptoBars(cryptoSymbols,Category.US_CRYPTO.name(), Timespan.M1.name(), 100, true);
+        // get crypto bars (startTime/endTime are optional timestamps in milliseconds; leave them null to omit the time range)
+        BarsQueryParam cryptoBarsParam = new BarsQueryParam();
+        cryptoBarsParam.setSymbols(new ArrayList<>(cryptoSymbols));
+        cryptoBarsParam.setCategory(Category.US_CRYPTO.name());
+        cryptoBarsParam.setTimespan(Timespan.M1.name());
+        cryptoBarsParam.setCount(100);
+        cryptoBarsParam.setRealTimeRequired(true);
+        cryptoBarsParam.setStartTime(1711262998500L);
+        cryptoBarsParam.setEndTime(1711349398500L);
+        List<NBar> cryptoBars = dataClient.getCryptoBars(cryptoBarsParam);
         logger.info("Crypto bars: {}", cryptoBars);
 
         //get crypto snapshot
@@ -115,7 +123,16 @@ public static void main(String[] args) {
         List<Snapshot> futureSnapshots = dataClient.getFuturesSnapshots(futuresSymbols, Category.US_FUTURES.name());
         logger.info("Futures Snapshots: {}", futureSnapshots);
 
-        List<NBar> futureBars = dataClient.getFuturesBars(new ArrayList<>(futuresSymbols), Category.US_FUTURES.name(), Timespan.M1.name(), 10, false);
+        // get futures bars (startTime/endTime are optional timestamps in milliseconds; leave them null to omit the time range)
+        BarsQueryParam futuresBarsParam = new BarsQueryParam();
+        futuresBarsParam.setSymbols(new ArrayList<>(futuresSymbols));
+        futuresBarsParam.setCategory(Category.US_FUTURES.name());
+        futuresBarsParam.setTimespan(Timespan.M1.name());
+        futuresBarsParam.setCount(10);
+        futuresBarsParam.setRealTimeRequired(false);
+        futuresBarsParam.setStartTime(1711262998500L);
+        futuresBarsParam.setEndTime(1711349398500L);
+        List<NBar> futureBars = dataClient.getFuturesBars(futuresBarsParam);
         logger.info("Futures Bars: {}", futureBars);
 
         List<FuturesProduct> futuresProducts = dataClient.getFuturesProducts(Category.US_FUTURES.name());
@@ -163,7 +180,16 @@ public static void main(String[] args) {
         List<OptionSnapshot> optionSnapshots = dataClient.getOptionSnapshots(optionSymbols, Category.US_OPTION.name());
         logger.info("Option Snapshots: {}", optionSnapshots);
 
-        List<OptionBars> optionBars = dataClient.getOptionBars(new ArrayList<>(optionSymbols), Category.US_OPTION.name(), Timespan.M1.name(), 10, false);
+        // get option bars (startTime/endTime are optional timestamps in milliseconds; leave them null to omit the time range)
+        BarsQueryParam optionBarsParam = new BarsQueryParam();
+        optionBarsParam.setSymbols(new ArrayList<>(optionSymbols));
+        optionBarsParam.setCategory(Category.US_OPTION.name());
+        optionBarsParam.setTimespan(Timespan.M1.name());
+        optionBarsParam.setCount(10);
+        optionBarsParam.setRealTimeRequired(false);
+        optionBarsParam.setStartTime(1711262998500L);
+        optionBarsParam.setEndTime(1711349398500L);
+        List<OptionBars> optionBars = dataClient.getOptionBars(optionBarsParam);
         logger.info("Option Bars: {}", optionBars);
 
         OptionTick OptionTicks = dataClient.getOptionTicks("AAPL260522C00300000", Category.US_OPTION.name(), 30);

webull-openapi-java-sdk-samples/src/main/java/com/webull/openapi/samples/data/DataClientEvent.java

@@ -65,7 +65,16 @@ public static void main(String[] args) {
         EventDepth eventDepth = dataClient.getEventDepth(symbol, Category.US_EVENT.name(), "10");
         logger.info("Event Depth: {}", eventDepth);
 
-        List<EventBars> eventBars = dataClient.getEventBars(symbols, Category.US_EVENT.name(), Timespan.M1.name(), 200, false);
+        // get event bars (startTime/endTime are optional timestamps in milliseconds; leave them null to omit the time range)
+        BarsQueryParam eventBarsParam = new BarsQueryParam();
+        eventBarsParam.setSymbols(new ArrayList<>(symbols));
+        eventBarsParam.setCategory(Category.US_EVENT.name());
+        eventBarsParam.setTimespan(Timespan.M1.name());
+        eventBarsParam.setCount(200);
+        eventBarsParam.setRealTimeRequired(false);
+        eventBarsParam.setStartTime(1711262998500L);
+        eventBarsParam.setEndTime(1711349398500L);
+        List<EventBars> eventBars = dataClient.getEventBars(eventBarsParam);
         logger.info("Event Bars: {}", eventBars);
 
         EventTick eventTick = dataClient.getEventTick(symbol, Category.US_EVENT.name(), 200);

webull-openapi-java-sdk/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>com.webull.openapi</groupId>
         <artifactId>webull-openapi-java-sdk-parent</artifactId>
-        <version>2.0.3</version>
+        <version>2.0.4</version>
     </parent>
 
     <artifactId>webull-openapi-java-sdk</artifactId>

webull-openapi-java-sdk/src/main/java/com/webull/openapi/core/config/ProjectReaderHelper.java

@@ -24,7 +24,7 @@ private ProjectReaderHelper() {
 
     private static final String APPLICATION_VERSION = "application.version";
 
-    private static final String DEFAULT_APPLICATION_VERSION = "2.0.3";
+    private static final String DEFAULT_APPLICATION_VERSION = "2.0.4";
 
     private static final String APPLICATION_NAME = "application.name";