Options Flow Leaderboard API

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/flow/options/leaderboard?n=10&windowMinutes=240"

import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/flow/options/leaderboard",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
resp.raise_for_status()
data = resp.json()
print(f"Top buyer: {data['buyers'][0]['symbol']}")

const resp = await fetch(
  "https://lab.flashalpha.com/v1/flow/options/leaderboard",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();
console.log("Top buyer: " + data.buyers[0].symbol);

{
  "generatedUtc": "2026-10-30T13:45:58.1288162Z",
  "n": 10,
  "windowMinutes": 240,
  "buyers": [
    {
      "symbol": "SPY",
      "netVolume": 57663,
      "netNotional": 14364083,
      "buyVolume": 435734,
      "sellVolume": 378071,
      "avgPremium": 2.49,
      "tradeCount": 144604,
      "lastTradeUtc": "2026-10-30T13:45:55.557Z"
    },
    {
      "symbol": "PLTR",
      "netVolume": 15952,
      "netNotional": 5754193,
      "buyVolume": 34996,
      "sellVolume": 19044,
      "avgPremium": 3.61,
      "tradeCount": 12102,
      "lastTradeUtc": "2026-10-30T13:45:53.808Z"
    }
  ],
  "sellers": [
    {
      "symbol": "SPX",
      "netVolume": -4651,
      "netNotional": -108068020,
      "buyVolume": 2461,
      "sellVolume": 7112,
      "avgPremium": 232.35,
      "tradeCount": 2628,
      "lastTradeUtc": "2026-10-30T13:45:54.931Z"
    },
    {
      "symbol": "SNDK",
      "netVolume": -4340,
      "netNotional": -12101101,
      "buyVolume": 8681,
      "sellVolume": 13021,
      "avgPremium": 27.88,
      "tradeCount": 15706,
      "lastTradeUtc": "2026-10-30T13:45:55.246Z"
    }
  ],
  "endpoint_version": "2026.09.30",
  "data_as_of": {
    "node": "fa4",
    "equity_feed": "2026-10-30T13:45:58.109Z",
    "equity_options_feed": "2026-10-30T13:45:57Z",
    "index_feed": "2026-10-30T13:45:56.132Z",
    "index_options_feed": "2026-10-30T13:45:54Z",
    "futures_feed": "2026-10-30T13:45:53.139Z",
    "futures_options_feed": "2026-10-30T13:45:49.971Z",
    "flow_feed": "2026-10-30T13:45:00Z",
    "oi_feed": "2026-10-29T20:00:00Z",
    "macro_feed": "2026-10-29T21:00:20Z"
  }
}