Add IPO, Payout and Smartlist models, API endpoints, and tests

README.md

@@ -30,7 +30,7 @@ Add this dependency to your project's POM:
 <dependency>
   <groupId>com.upstox.api</groupId>
   <artifactId>upstox-java-sdk</artifactId>
-  <version>1.26</version>
+  <version>1.27</version>
   <scope>compile</scope>
 </dependency>
 ```
@@ -40,7 +40,7 @@ Add this dependency to your project's POM:
 Add this dependency to your project's build file:
 
 ```groovy
-compile "com.upstox.api:upstox-java-sdk:1.26"
+compile "com.upstox.api:upstox-java-sdk:1.27"
 ```
 
 ## Sandbox Mode

examples/ipo/README.md

@@ -0,0 +1,11 @@
+# IPO API – Example code
+
+Links to all IPO-related examples in the `code/` folder.
+
+## 1. IPO Listing
+
+- 1.1 [Get IPO listing](code/get-ipo-listing.md#get-ipo-listing)
+
+## 2. IPO Details
+
+- 2.1 [Get IPO details](code/get-ipo-details.md#get-ipo-details)

examples/ipo/code/get-ipo-details.md

@@ -0,0 +1,31 @@
+## Get IPO details
+
+```java
+import com.upstox.ApiClient;
+import com.upstox.ApiException;
+import com.upstox.Configuration;
+import com.upstox.api.IpoDetailsResponse;
+import com.upstox.auth.OAuth;
+import io.swagger.client.api.IpoApi;
+
+public class Main {
+    public static void main(String[] args) {
+        ApiClient defaultClient = Configuration.getDefaultApiClient();
+
+        OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
+        OAUTH2.setAccessToken("{your_access_token}");
+
+        IpoApi apiInstance = new IpoApi();
+
+        String id = "{ipo_slug_id}";
+
+        try {
+            IpoDetailsResponse result = apiInstance.getIpoDetails(id);
+            System.out.println(result);
+        } catch (ApiException e) {
+            System.err.println("Exception when calling IpoApi#getIpoDetails");
+            e.printStackTrace();
+        }
+    }
+}
+```

examples/ipo/code/get-ipo-listing.md

@@ -0,0 +1,30 @@
+## Get IPO listing
+
+```java
+import com.upstox.ApiClient;
+import com.upstox.ApiException;
+import com.upstox.Configuration;
+import com.upstox.api.IpoListingResponse;
+import com.upstox.auth.OAuth;
+import io.swagger.client.api.IpoApi;
+
+public class Main {
+    public static void main(String[] args) {
+        ApiClient defaultClient = Configuration.getDefaultApiClient();
+
+        OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
+        OAUTH2.setAccessToken("{your_access_token}");
+
+        IpoApi apiInstance = new IpoApi();
+
+        // status: open, closed, listed, upcoming | issueType: regular, sme
+        try {
+            IpoListingResponse result = apiInstance.getIpoListing("open", "regular", 1, 20);
+            System.out.println(result);
+        } catch (ApiException e) {
+            System.err.println("Exception when calling IpoApi#getIpoListing");
+            e.printStackTrace();
+        }
+    }
+}
+```

examples/payments-api/README.md

@@ -9,3 +9,10 @@ Links to all payments-related examples in the `code/` folder.
 ## 2. Get Payout History
 
 - 2.1 [Get payout history for the user](code/get-payout-history.md#get-payout-history-for-the-user)
+
+## 3. Payout Management
+
+- 3.1 [Get available payout modes](code/get-payout-modes.md#get-available-payout-modes)
+- 3.2 [Initiate a payout](code/initiate-payout.md#initiate-a-payout)
+- 3.3 [Modify a pending payout](code/modify-payout.md#modify-a-pending-payout)
+- 3.4 [Cancel a pending payout](code/cancel-payout.md#cancel-a-pending-payout)

examples/payments-api/code/cancel-payout.md

@@ -0,0 +1,31 @@
+## Cancel a pending payout
+
+```java
+import com.upstox.ApiClient;
+import com.upstox.ApiException;
+import com.upstox.Configuration;
+import com.upstox.api.PayoutDetailsResponse;
+import com.upstox.auth.OAuth;
+import io.swagger.client.api.UserApi;
+
+public class Main {
+    public static void main(String[] args) {
+        ApiClient defaultClient = Configuration.getDefaultApiClient();
+
+        OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
+        OAUTH2.setAccessToken("{your_access_token}");
+
+        UserApi apiInstance = new UserApi();
+
+        String transactionId = "{your_transaction_id}";
+
+        try {
+            PayoutDetailsResponse result = apiInstance.cancelPayout(transactionId);
+            System.out.println(result);
+        } catch (ApiException e) {
+            System.err.println("Exception when calling UserApi#cancelPayout");
+            e.printStackTrace();
+        }
+    }
+}
+```

examples/payments-api/code/get-payout-modes.md

@@ -0,0 +1,29 @@
+## Get available payout modes
+
+```java
+import com.upstox.ApiClient;
+import com.upstox.ApiException;
+import com.upstox.Configuration;
+import com.upstox.api.PayoutModesResponse;
+import com.upstox.auth.OAuth;
+import io.swagger.client.api.UserApi;
+
+public class Main {
+    public static void main(String[] args) {
+        ApiClient defaultClient = Configuration.getDefaultApiClient();
+
+        OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
+        OAUTH2.setAccessToken("{your_access_token}");
+
+        UserApi apiInstance = new UserApi();
+
+        try {
+            PayoutModesResponse result = apiInstance.getPayoutModes();
+            System.out.println(result);
+        } catch (ApiException e) {
+            System.err.println("Exception when calling UserApi#getPayoutModes");
+            e.printStackTrace();
+        }
+    }
+}
+```

examples/payments-api/code/initiate-payout.md

@@ -0,0 +1,34 @@
+## Initiate a payout
+
+```java
+import com.upstox.ApiClient;
+import com.upstox.ApiException;
+import com.upstox.Configuration;
+import com.upstox.api.InitiatePayoutRequest;
+import com.upstox.api.PayoutDetailsResponse;
+import com.upstox.auth.OAuth;
+import io.swagger.client.api.UserApi;
+
+public class Main {
+    public static void main(String[] args) {
+        ApiClient defaultClient = Configuration.getDefaultApiClient();
+
+        OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
+        OAUTH2.setAccessToken("{your_access_token}");
+
+        UserApi apiInstance = new UserApi();
+
+        InitiatePayoutRequest body = new InitiatePayoutRequest();
+        body.setMode("NEFT");
+        body.setAmount(5000.0);
+
+        try {
+            PayoutDetailsResponse result = apiInstance.initiatePayout(body);
+            System.out.println(result);
+        } catch (ApiException e) {
+            System.err.println("Exception when calling UserApi#initiatePayout");
+            e.printStackTrace();
+        }
+    }
+}
+```

examples/payments-api/code/modify-payout.md

@@ -0,0 +1,34 @@
+## Modify a pending payout
+
+```java
+import com.upstox.ApiClient;
+import com.upstox.ApiException;
+import com.upstox.Configuration;
+import com.upstox.api.ModifyPayoutRequest;
+import com.upstox.api.PayoutDetailsResponse;
+import com.upstox.auth.OAuth;
+import io.swagger.client.api.UserApi;
+
+public class Main {
+    public static void main(String[] args) {
+        ApiClient defaultClient = Configuration.getDefaultApiClient();
+
+        OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
+        OAUTH2.setAccessToken("{your_access_token}");
+
+        UserApi apiInstance = new UserApi();
+
+        ModifyPayoutRequest body = new ModifyPayoutRequest();
+        body.setAmount(6000.0);
+        String transactionId = "{your_transaction_id}";
+
+        try {
+            PayoutDetailsResponse result = apiInstance.modifyPayout(body, transactionId);
+            System.out.println(result);
+        } catch (ApiException e) {
+            System.err.println("Exception when calling UserApi#modifyPayout");
+            e.printStackTrace();
+        }
+    }
+}
+```

examples/smartlist/README.md

@@ -0,0 +1,15 @@
+# Smartlist API – Example code
+
+Links to all smartlist-related examples in the `code/` folder.
+
+## 1. Smartlist Futures
+
+- 1.1 [Get smartlist futures](code/get-smartlist-futures.md#get-smartlist-futures)
+
+## 2. Smartlist MTF
+
+- 2.1 [Get smartlist MTF](code/get-smartlist-mtf.md#get-smartlist-mtf)
+
+## 3. Smartlist Options
+
+- 3.1 [Get smartlist options](code/get-smartlist-options.md#get-smartlist-options)

examples/smartlist/code/get-smartlist-futures.md

@@ -0,0 +1,29 @@
+## Get smartlist futures
+
+```java
+import com.upstox.ApiClient;
+import com.upstox.ApiException;
+import com.upstox.Configuration;
+import com.upstox.api.AnalyticsResponse;
+import com.upstox.auth.OAuth;
+import io.swagger.client.api.MarketApi;
+
+public class Main {
+    public static void main(String[] args) {
+        ApiClient defaultClient = Configuration.getDefaultApiClient();
+
+        OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
+        OAUTH2.setAccessToken("{your_access_token}");
+
+        MarketApi apiInstance = new MarketApi();
+
+        try {
+            AnalyticsResponse result = apiInstance.getSmartlistFutures("EQUITY", "active", 1, 20);
+            System.out.println(result);
+        } catch (ApiException e) {
+            System.err.println("Exception when calling MarketApi#getSmartlistFutures");
+            e.printStackTrace();
+        }
+    }
+}
+```

examples/smartlist/code/get-smartlist-mtf.md

@@ -0,0 +1,29 @@
+## Get smartlist MTF
+
+```java
+import com.upstox.ApiClient;
+import com.upstox.ApiException;
+import com.upstox.Configuration;
+import com.upstox.api.AnalyticsResponse;
+import com.upstox.auth.OAuth;
+import io.swagger.client.api.MarketApi;
+
+public class Main {
+    public static void main(String[] args) {
+        ApiClient defaultClient = Configuration.getDefaultApiClient();
+
+        OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
+        OAUTH2.setAccessToken("{your_access_token}");
+
+        MarketApi apiInstance = new MarketApi();
+
+        try {
+            AnalyticsResponse result = apiInstance.getSmartlistMtf(1, 20);
+            System.out.println(result);
+        } catch (ApiException e) {
+            System.err.println("Exception when calling MarketApi#getSmartlistMtf");
+            e.printStackTrace();
+        }
+    }
+}
+```

examples/smartlist/code/get-smartlist-options.md

@@ -0,0 +1,29 @@
+## Get smartlist options
+
+```java
+import com.upstox.ApiClient;
+import com.upstox.ApiException;
+import com.upstox.Configuration;
+import com.upstox.api.AnalyticsResponse;
+import com.upstox.auth.OAuth;
+import io.swagger.client.api.MarketApi;
+
+public class Main {
+    public static void main(String[] args) {
+        ApiClient defaultClient = Configuration.getDefaultApiClient();
+
+        OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
+        OAUTH2.setAccessToken("{your_access_token}");
+
+        MarketApi apiInstance = new MarketApi();
+
+        try {
+            AnalyticsResponse result = apiInstance.getSmartlistOptions("EQUITY", "active", 1, 20);
+            System.out.println(result);
+        } catch (ApiException e) {
+            System.err.println("Exception when calling MarketApi#getSmartlistOptions");
+            e.printStackTrace();
+        }
+    }
+}
+```

pom.xml

@@ -6,7 +6,7 @@
 	<artifactId>upstox-java-sdk</artifactId>
 	<packaging>jar</packaging>
 	<name>upstox-java-sdk</name>
-	<version>1.26</version>
+	<version>1.27</version>
 	<url>https://upstox.com/uplink/</url>
 	<description>The official Java client for communicating with the Upstox API</description>
 	<prerequisites>

src/main/java/com/upstox/ApiClient.java

@@ -1014,7 +1014,7 @@ public Call buildCall(String path, String method, List<Pair> queryParams, List<P
     public Request buildRequest(String path, String method, List<Pair> queryParams, List<Pair> collectionQueryParams, Object body, Map<String, String> headerParams, Map<String, Object> formParams, String[] authNames, ProgressRequestBody.ProgressRequestListener progressRequestListener) throws ApiException {
         updateParamsForAuth(authNames, queryParams, headerParams);
         headerParams.put("X-Upstox-SDK-Language","java");
-        headerParams.put("X-Upstox-SDK-Version","1.26");
+        headerParams.put("X-Upstox-SDK-Version","1.27");
         final String url = buildUrl(path, queryParams, collectionQueryParams);
         final Request.Builder reqBuilder = new Request.Builder().url(url);
         processHeaderParams(headerParams, reqBuilder);