Flow Signals Summary API - Net Bullish/Bearish Premium Roll-up | FlashAlpha
  1. Flow Signals Summary

Flow Signals Summary API

Net bullish vs bearish premium, opening vs closing premium, and the top-10 highest-scoring signals - in one cheap call you can fan across a watchlist for a smart-money tilt read.

Endpoint

GET /v1/flow/signals/{symbol}/summary
Auth required (X-Api-Key) Rate Limited: Yes Plan: Alpha+

Parameters

Name In Type Required Default Description
symbol path string required - Underlying symbol
windowMinutes query integer 240 Look-back window in minutes (1-10080). Non-numeric values return a 400 problem-details body. Out-of-range values are clamped to the supported range.
expiry query date all expiries Filter the chain to a single expiry (yyyy-MM-dd). Invalid values return 400 invalid_expiry. An expiry with no data returns an empty result, not an error.

Request

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/flow/signals/NVDA/summary?windowMinutes=240"
import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/flow/signals/NVDA/summary",
    params={"windowMinutes": 240},
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
resp.raise_for_status()
data = resp.json()
print(f"Signals: {data['signal_count']}")
print(f"Net directional: ${data['net_directional_premium']:,.0f}")
print(f"Opening / Closing: ${data['opening_premium']:,.0f} / ${data['closing_premium']:,.0f}")
const resp = await fetch(
  "https://lab.flashalpha.com/v1/flow/signals/NVDA/summary?windowMinutes=240",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();
console.log(`Signals: ${data.signal_count}`);
console.log(`Net directional: $${data.net_directional_premium.toLocaleString()}`);

Try it live

Runs on live market data and uses 1 request from your daily quota.

GET

Response

{
  "symbol": "NVDA",
  "as_of": "2026-10-30T13:45:59.5475119Z",
  "window_minutes": 240,
  "expiry": null,
  "underlying_price": 206.425,
  "signal_count": 358,
  "bullish_premium": 1804474,
  "bearish_premium": 1529112,
  "net_directional_premium": 275362,
  "opening_premium": 11510599,
  "closing_premium": 10651696,
  "top_signals": [
    {
      "ts": "2026-10-30T13:30:51.343Z",
      "expiry": "2026-11-04",
      "strike": 230,
      "right": "P",
      "side": "buy",
      "price": 22,
      "size": 200,
      "premium": 440000,
      "dte": 5,
      "structure": "block",
      "aggressor": "at_ask",
      "open_close_bias": "opening_bias",
      "open_close_confidence": 0.43,
      "contract_net_oi_delta": 86,
      "intent": "bearish",
      "score": 75,
      "conviction": "medium",
      "tags": [
        "block",
        "opening",
        "golden"
      ],
      "score_breakdown": {
        "premium": 14,
        "size_vs_oi": 18,
        "aggressor": 14,
        "sweep": 10,
        "opening_bias": 9,
        "tenor": 10
      },
      "enrichment": {
        "iv": 0.469418,
        "delta": -0.969288,
        "gamma": 0.005935,
        "iv_vs_atm": 0.117987,
        "moneyness": "ITM",
        "estimated_delta_notional": -4001705,
        "hypothetical_gex_impact_if_opening": 50581.55
      }
    },
    {
      "ts": "2026-10-30T13:38:49.745Z",
      "expiry": "2026-10-30",
      "strike": 210,
      "right": "C",
      "side": "buy",
      "price": 0.32,
      "size": 1411,
      "premium": 45152,
      "dte": 0,
      "structure": "sweep",
      "aggressor": "at_ask",
      "open_close_bias": "opening_bias",
      "open_close_confidence": 0.43,
      "contract_net_oi_delta": 371,
      "intent": "bullish",
      "score": 70,
      "conviction": "medium",
      "tags": [
        "sweep",
        "opening",
        "0dte"
      ],
      "score_breakdown": {
        "premium": 12,
        "size_vs_oi": 6,
        "aggressor": 14,
        "sweep": 18,
        "opening_bias": 9,
        "tenor": 11
      },
      "enrichment": {
        "iv": 0.551843,
        "delta": 0.123693,
        "gamma": 0.067247,
        "iv_vs_atm": 0.000175,
        "moneyness": "OTM",
        "estimated_delta_notional": 3602745,
        "hypothetical_gex_impact_if_opening": 4043196
      }
    }
  ],
  "endpoint_version": "2026.09.30",
  "data_as_of": {
    "node": "fa5",
    "equity_feed": "2026-10-30T13:45:59.233Z",
    "equity_options_feed": "2026-10-30T13:45:59Z",
    "index_feed": "2026-10-30T13:45:59.095Z",
    "index_options_feed": "2026-10-30T13:45:59Z",
    "futures_feed": "2026-10-30T13:45:51.589Z",
    "futures_options_feed": "2026-10-30T13:45:51.596Z",
    "flow_feed": "2026-10-30T13:45:00Z",
    "oi_feed": "2026-10-29T20:00:00Z",
    "macro_feed": "2026-10-29T21:00:20Z"
  }
}

Sending request…

See this endpoint on live data

Send this exact request and the real response shows up here, right next to the example.

Top-level fields

Field Type Description
symbol / as_ofstringSymbol and ISO 8601 request timestamp
window_minutesnumberEcho of the requested look-back window
expirystring, nullableEcho of the requested expiry filter (null when aggregating across all expiries)
underlying_pricenumberSpot at request time (0 when the settled chain snapshot is unavailable)
signal_countnumberFull count of signals in the window (not capped at 10)
bullish_premiumnumberSum of premium across signals classified intent=bullish
bearish_premiumnumberSum of premium across signals classified intent=bearish
net_directional_premiumnumberbullish_premium − bearish_premium
opening_premiumnumberSum of premium across signals where open_close_bias = opening_bias
closing_premiumnumberSum of premium across signals where open_close_bias = closing_bias
top_signalsarrayUp to 10 highest-scoring signals - same shape as /v1/flow/signals/{symbol}
endpoint_version, data_as_ofstring, objectResponse envelope, see Response envelope.

Fields of top_signals[]

Field Type Description
top_signals[].tsstringTimestamp of the print, or of the last leg of a sweep (UTC)
top_signals[].strikenumberStrike price
top_signals[].rightstringTop signals: right
top_signals[].sidestringTop signals: side
top_signals[].pricenumberTop signals: price
top_signals[].sizenumberTop signals: size
top_signals[].premiumnumberTop signals: premium
top_signals[].dtenumberDays to expiration
top_signals[].structurestringTop signals: structure
top_signals[].aggressorstringTop signals: aggressor
top_signals[].open_close_biasstringTop signals: open close bias
top_signals[].open_close_confidencenumberTop signals: open close confidence
top_signals[].contract_net_oi_deltanumberTop signals: contract net OI delta
top_signals[].intentstringTop signals: intent
top_signals[].scorenumberTop signals: score
top_signals[].convictionstringTop signals: conviction
top_signals[].tagsarray of stringTop signals: tags
top_signals[].score_breakdownobjectTop signals: score breakdown
top_signals[].score_breakdown.premiumnumberScore breakdown: premium
top_signals[].score_breakdown.size_vs_oinumberScore breakdown: size vs OI
top_signals[].score_breakdown.aggressornumberScore breakdown: aggressor
top_signals[].score_breakdown.sweepnumberScore breakdown: sweep
top_signals[].score_breakdown.opening_biasnumberScore breakdown: opening bias
top_signals[].score_breakdown.tenornumberScore breakdown: tenor
top_signals[].enrichmentobjectTop signals: enrichment
top_signals[].enrichment.ivnumberImplied volatility
top_signals[].enrichment.deltanumberEnrichment: delta
top_signals[].enrichment.gammanumberEnrichment: gamma
top_signals[].enrichment.iv_vs_atmnumberEnrichment: IV vs ATM
top_signals[].enrichment.moneynessstringEnrichment: moneyness
top_signals[].enrichment.estimated_delta_notionalnumberEnrichment: estimated delta notional
top_signals[].enrichment.hypothetical_gex_impact_if_openingnumberEnrichment: hypothetical GEX impact if opening
top_signals[].expirystringThe contract's own expiry date (yyyy-MM-dd, never null)

Errors

Status Error When
400invalid_expiryexpiry is not a valid yyyy-MM-dd date.
400-A query value has the wrong type, or a required value is missing. The body is an RFC 7807 problem-details object with errors.<param>.
401-Missing or invalid X-Api-Key. The body is empty; check the status code before parsing JSON.
403tier_restrictedYour plan is below Alpha. The body includes current_plan and required_plan.
429Quota exceededDaily quota used up. Retry-After gives the seconds until the reset at 00:00 UTC. Rejected requests (including 403) count toward the quota.

About the Summary

The summary is the watchlist-scale version of /v1/flow/signals. The full feed is great for a single name, but quickly gets expensive when you want a tilt read on 50 symbols. The summary aggregates the same scored signals into five headline premium roll-ups and embeds only the 10 highest-scoring signals so the response stays tight.

The net_directional_premium tells you whether bullish or bearish flow dominated the window. The opening_premium vs closing_premium split tells you whether positioning is being established or unwound - a high net-directional with a high opening share is the cleanest tilt read.

Common Use Cases

  • Run a watchlist tilt scanner - fan across a universe and rank by net_directional_premium / underlying_price for size-adjusted bullishness, surfacing the names worth a closer look
  • Build a sector flow dashboard - roll up signal-summary calls across a sector ETF's holdings to spot rotation between bullish and bearish premium
  • Decompose positioning - diff opening_premium against closing_premium to separate fresh positioning from unwinds, and treat high-opening with high net-directional as the cleanest tilt
  • Gate the full feed cheaply - poll the summary, then call /v1/flow/signals only when signal_count or net_directional_premium crosses a threshold
  • Preview the leaders - inspect the embedded top_signals to see which strikes and structures drove the tilt without a second request
  • Generate a daily report - take an end-of-day snapshot with windowMinutes=390 for a one-line-per-name flow tilt across the book

Related reading

Complementary endpoints

Ready to build with FlashAlpha?

Get your free API key and start pulling live options data in 60 seconds.

No credit card required Setup in 60 seconds Secure & reliable