FlashAlpha Java SDK

<dependency>
    <groupId>com.flashalpha</groupId>
    <artifactId>flashalpha</artifactId>
    <version>0.3.0</version>
</dependency>

implementation("com.flashalpha:flashalpha:0.3.0")

import com.flashalpha.FlashAlphaClient;
import com.google.gson.JsonObject;

FlashAlphaClient client = new FlashAlphaClient("YOUR_API_KEY");

// Gamma exposure for SPY
JsonObject gex = client.gex("SPY");
System.out.println(gex.get("net_gex") + " / flip " + gex.get("gamma_flip"));

// Key support / resistance levels
JsonObject key = client.exposureLevels("SPY")
    .getAsJsonObject("levels");
System.out.println("Call wall: " + key.get("call_wall"));

// BSM greeks for a single contract
JsonObject g = client.greeks(655, 660, 7, 0.18, "call", null, null);
System.out.println("delta=" + g.get("delta"));

import java.util.*;

Map<String, Object> body = new LinkedHashMap<>();
body.put("filters", Map.of(
    "op", "and",
    "conditions", List.of(
        Map.of("field", "regime",        "operator", "eq",  "value", "positive_gamma"),
        Map.of("field", "harvest_score", "operator", "gte", "value", 65)
    )));
body.put("sort",   List.of(Map.of("field", "harvest_score", "direction", "desc")));
body.put("select", List.of("symbol", "price", "harvest_score"));

JsonObject screen = client.screener(body);
screen.getAsJsonArray("data").forEach(row ->
    System.out.println(row.getAsJsonObject().get("symbol")));

import com.google.gson.Gson;
import com.google.gson.annotations.SerializedName;

record GexSummary(
    @SerializedName("net_gex")    double netGex,
    @SerializedName("gamma_flip") double gammaFlip) {}

Gson gson = new Gson();
GexSummary s = gson.fromJson(client.gex("SPY"), GexSummary.class);
System.out.println(s.netGex() + " / " + s.gammaFlip());

// Methods have overloads for optional params
JsonObject all    = client.gex("SPY");
JsonObject friday = client.gex("SPY", "2026-04-10", 500);  // expiry, min OI

import com.flashalpha.FlashAlphaClient
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext

val fa = FlashAlphaClient("YOUR_API_KEY")

suspend fun getGex(symbol: String) = withContext(Dispatchers.IO) {
    fa.gex(symbol)
}

try {
    client.narrative("SPY");
} catch (TierRestrictedException e) {
    System.out.println("Upgrade from " + e.getCurrentPlan()
                        + " to " + e.getRequiredPlan());
} catch (RateLimitException e) {
    System.out.println("Retry after " + e.getRetryAfter() + "s");
} catch (NotFoundException e) {
    System.out.println("Symbol not found");
} catch (FlashAlphaException e) {
    System.out.println("API error " + e.getStatusCode()
                        + ": " + e.getMessage());
}

// Default base URL
FlashAlphaClient client = new FlashAlphaClient("YOUR_API_KEY");

// Override base URL (useful for MockWebServer in tests)
FlashAlphaClient client = new FlashAlphaClient(
    "YOUR_API_KEY",
    "https://lab.flashalpha.com"
);

// Timeout is fixed at 30 seconds.