docs: add Java SDK documentation

.github/workflows/sync-sdk-docs.yml

@@ -31,17 +31,18 @@ on:
     branches: [staging]
     paths:
       - 'sdk/js/**'
+      - 'sdk/java/**'
       - 'lib/mdx-to-md.js'
       - 'scripts/export-sdk-docs.js'
       - '.github/workflows/sync-sdk-docs.yml'
   workflow_dispatch:
     inputs:
       sdk:
-        description: 'Which SDK to sync (pilot: js only)'
+        description: 'Which SDK to sync'
         required: true
         default: 'js'
         type: choice
-        options: [js]
+        options: [js, java]
 
 env:
   SOURCE_OWNER: MarketDataApp
@@ -56,7 +57,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        sdk: [js]
+        sdk: [js, java]
     steps:
       - name: Checkout documentation source
         uses: actions/checkout@v4

api/authentication.mdx

@@ -140,6 +140,44 @@ func main() {
 }
 ```
 
+</TabItem>
+<TabItem value="Java" label="Java">
+
+```java title="App.java"
+import com.marketdata.sdk.MarketDataClient;
+import com.marketdata.sdk.stocks.StockQuoteRequest;
+
+public class App {
+  public static void main(String[] args) {
+    // The no-arg constructor reads your token from the MARKETDATA_TOKEN
+    // environment variable (or a .env file in the working directory).
+    // Alternatively, pass it directly:
+    //   new MarketDataClient("your_token_here", null, null, true)
+    try (MarketDataClient client = new MarketDataClient()) {
+      client.stocks().quote(StockQuoteRequest.of("SPY")).values().forEach(System.out::println);
+    }
+  }
+}
+```
+
+</TabItem>
+<TabItem value="Kotlin" label="Kotlin">
+
+```kotlin title="App.kt"
+import com.marketdata.sdk.MarketDataClient
+import com.marketdata.sdk.stocks.StockQuoteRequest
+
+fun main() {
+    // The no-arg constructor reads your token from the MARKETDATA_TOKEN
+    // environment variable (or a .env file in the working directory).
+    // Alternatively, pass it directly:
+    //   MarketDataClient("your_token_here", null, null, true)
+    MarketDataClient().use { client ->
+        client.stocks().quote(StockQuoteRequest.of("SPY")).values().forEach(::println)
+    }
+}
+```
+
 </TabItem>
 </Tabs>
 

api/funds/candles.mdx

@@ -119,6 +119,52 @@ $candles = $client->mutual_funds->candles(
 // Display formatted candles summary
 echo $candles;
 ```
+</TabItem>
+<TabItem value="Java" label="Java">
+
+```java title="FundCandles.java"
+import com.marketdata.sdk.MarketDataClient;
+import com.marketdata.sdk.funds.FundCandlesRequest;
+import com.marketdata.sdk.funds.FundResolution;
+
+public class FundCandles {
+  public static void main(String[] args) {
+    try (MarketDataClient client = new MarketDataClient()) {
+      // VFINX is available without authentication (free test symbol).
+      client.funds()
+          .candles(FundCandlesRequest.builder(FundResolution.DAILY, "VFINX")
+              .countback(30)
+              .build())
+          .values()
+          .forEach(System.out::println);
+    }
+  }
+}
+```
+
+</TabItem>
+<TabItem value="Kotlin" label="Kotlin">
+
+```kotlin title="FundCandles.kt"
+import com.marketdata.sdk.MarketDataClient
+import com.marketdata.sdk.funds.FundCandlesRequest
+import com.marketdata.sdk.funds.FundResolution
+
+fun main() {
+    MarketDataClient().use { client ->
+        // VFINX is available without authentication (free test symbol).
+        client.funds()
+            .candles(
+                FundCandlesRequest.builder(FundResolution.DAILY, "VFINX")
+                    .countback(30)
+                    .build()
+            )
+            .values()
+            .forEach(::println)
+    }
+}
+```
+
 </TabItem>
 </Tabs>
 

api/markets/status.mdx

@@ -143,6 +143,62 @@ $yesterday = $client->markets->status(
 );
 echo $yesterday;
 ```
+</TabItem>
+<TabItem value="Java" label="Java">
+
+```java title="MarketStatusApp.java"
+import com.marketdata.sdk.MarketDataClient;
+import com.marketdata.sdk.markets.MarketStatusRequest;
+import java.time.LocalDate;
+
+public class MarketStatusApp {
+  public static void main(String[] args) {
+    try (MarketDataClient client = new MarketDataClient()) {
+      client.markets()
+          .status(MarketStatusRequest.builder()
+              .from(LocalDate.of(2020, 1, 1))
+              .to(LocalDate.of(2020, 12, 31))
+              .build())
+          .values()
+          .forEach(System.out::println);
+
+      client.markets()
+          .status(MarketStatusRequest.of())
+          .values()
+          .forEach(System.out::println);
+    }
+  }
+}
+```
+
+</TabItem>
+<TabItem value="Kotlin" label="Kotlin">
+
+```kotlin title="MarketStatusApp.kt"
+import com.marketdata.sdk.MarketDataClient
+import com.marketdata.sdk.markets.MarketStatusRequest
+import java.time.LocalDate
+
+fun main() {
+    MarketDataClient().use { client ->
+        client.markets()
+            .status(
+                MarketStatusRequest.builder()
+                    .from(LocalDate.of(2020, 1, 1))
+                    .to(LocalDate.of(2020, 12, 31))
+                    .build()
+            )
+            .values()
+            .forEach(::println)
+
+        client.markets()
+            .status(MarketStatusRequest.of())
+            .values()
+            .forEach(::println)
+    }
+}
+```
+
 </TabItem>
 </Tabs>
 

api/options/chain.mdx

@@ -108,6 +108,30 @@ $calls = $chain->getCalls();
 $puts = $chain->getPuts();
 $strikes = $chain->getStrikes();
 ```
+</TabItem>
+<TabItem value="Java" label="Java">
+
+```java title="OptionChain.java"
+import com.marketdata.sdk.MarketDataClient;
+import com.marketdata.sdk.options.OptionsChainRequest;
+
+try (MarketDataClient client = new MarketDataClient()) {
+    client.options().chain(OptionsChainRequest.of("AAPL")).values().forEach(System.out::println);
+}
+```
+
+</TabItem>
+<TabItem value="Kotlin" label="Kotlin">
+
+```kotlin title="OptionChain.kt"
+import com.marketdata.sdk.MarketDataClient
+import com.marketdata.sdk.options.OptionsChainRequest
+
+MarketDataClient().use { client ->
+    client.options().chain(OptionsChainRequest.of("AAPL")).values().forEach(::println)
+}
+```
+
 </TabItem>
 </Tabs>
 

api/options/expirations.mdx

@@ -108,6 +108,30 @@ $expirations = $client->options->expirations("AAPL");
 // Display all expiration dates
 echo $expirations;
 ```
+</TabItem>
+<TabItem value="Java" label="Java">
+
+```java title="OptionExpirations.java"
+import com.marketdata.sdk.MarketDataClient;
+import com.marketdata.sdk.options.OptionsExpirationsRequest;
+
+try (MarketDataClient client = new MarketDataClient()) {
+    client.options().expirations(OptionsExpirationsRequest.of("AAPL")).values().forEach(System.out::println);
+}
+```
+
+</TabItem>
+<TabItem value="Kotlin" label="Kotlin">
+
+```kotlin title="OptionExpirations.kt"
+import com.marketdata.sdk.MarketDataClient
+import com.marketdata.sdk.options.OptionsExpirationsRequest
+
+MarketDataClient().use { client ->
+    client.options().expirations(OptionsExpirationsRequest.of("AAPL")).values().forEach(::println)
+}
+```
+
 </TabItem>
 </Tabs>
 

api/options/lookup.mdx

@@ -100,6 +100,32 @@ $lookup = $client->options->lookup("AAPL 7/28/2023 200 Call");
 // Display the OCC symbol
 echo $lookup;
 ```
+</TabItem>
+<TabItem value="Java" label="Java">
+
+```java title="OptionLookup.java"
+import com.marketdata.sdk.MarketDataClient;
+import com.marketdata.sdk.options.OptionsLookupRequest;
+
+try (MarketDataClient client = new MarketDataClient()) {
+    System.out.println(client.options().lookup(OptionsLookupRequest.of("AAPL 7/28/2023 200 Call")).values());  // "AAPL230728C00200000"
+}
+```
+
+</TabItem>
+<TabItem value="Kotlin" label="Kotlin">
+
+```kotlin title="OptionLookup.kt"
+import com.marketdata.sdk.MarketDataClient
+import com.marketdata.sdk.options.OptionsLookupRequest
+
+MarketDataClient().use { client ->
+    val optionSymbol =
+        client.options().lookup(OptionsLookupRequest.of("AAPL 7/28/2023 200 Call")).values()
+    println(optionSymbol)  // "AAPL230728C00200000"
+}
+```
+
 </TabItem>
 </Tabs>
 

api/options/quotes.mdx

@@ -112,6 +112,30 @@ $quotes = $client->options->quotes("AAPL271217C00250000");
 // Display formatted quotes with Greeks
 echo $quotes;
 ```
+</TabItem>
+<TabItem value="Java" label="Java">
+
+```java title="OptionQuotes.java"
+import com.marketdata.sdk.MarketDataClient;
+import com.marketdata.sdk.options.OptionsQuoteRequest;
+
+try (MarketDataClient client = new MarketDataClient()) {
+    client.options().quote(OptionsQuoteRequest.of("AAPL271217C00250000")).values().forEach(System.out::println);
+}
+```
+
+</TabItem>
+<TabItem value="Kotlin" label="Kotlin">
+
+```kotlin title="OptionQuotes.kt"
+import com.marketdata.sdk.MarketDataClient
+import com.marketdata.sdk.options.OptionsQuoteRequest
+
+MarketDataClient().use { client ->
+    client.options().quote(OptionsQuoteRequest.of("AAPL271217C00250000")).values().forEach(::println)
+}
+```
+
 </TabItem>
 </Tabs>
 

api/stocks/bulkcandles.mdx

@@ -121,6 +121,52 @@ $candles = $client->stocks->bulkCandles(
 // Display formatted candles summary
 echo $candles;
 ```
+</TabItem>
+<TabItem value="Java" label="Java">
+
+:::note
+The Java SDK does not yet provide a method for the bulk candles endpoint, so this example uses the JDK's `java.net.http.HttpClient` directly. It will be replaced with a `marketdata-sdk-java` example once bulk support is added.
+:::
+
+```java title="BulkStockCandles.java"
+import java.net.URI;
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+
+HttpClient http = HttpClient.newHttpClient();
+HttpRequest request = HttpRequest.newBuilder()
+    .uri(URI.create("https://api.marketdata.app/v1/stocks/bulkcandles/D/?symbols=AAPL,META,MSFT"))
+    .header("Authorization", "Bearer " + System.getenv("MARKETDATA_TOKEN"))
+    .GET()
+    .build();
+HttpResponse<String> response = http.send(request, HttpResponse.BodyHandlers.ofString());
+System.out.println(response.body());
+```
+
+</TabItem>
+<TabItem value="Kotlin" label="Kotlin">
+
+:::note
+The Java SDK does not yet provide a method for the bulk candles endpoint, so this example uses the JDK's `java.net.http.HttpClient` directly. It will be replaced with a `marketdata-sdk-java` example once bulk support is added.
+:::
+
+```kotlin title="BulkStockCandles.kt"
+import java.net.URI
+import java.net.http.HttpClient
+import java.net.http.HttpRequest
+import java.net.http.HttpResponse
+
+val http = HttpClient.newHttpClient()
+val request = HttpRequest.newBuilder()
+    .uri(URI.create("https://api.marketdata.app/v1/stocks/bulkcandles/D/?symbols=AAPL,META,MSFT"))
+    .header("Authorization", "Bearer ${System.getenv("MARKETDATA_TOKEN")}")
+    .GET()
+    .build()
+val response = http.send(request, HttpResponse.BodyHandlers.ofString())
+println(response.body())
+```
+
 </TabItem>
 </Tabs>