Stocks Cumulative Net Flow API

Endpoint

Parameters

Request

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/flow/stocks/SPY/cumulative?minutes=240"

import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/flow/stocks/SPY/cumulative",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
resp.raise_for_status()
data = resp.json()
print(f"Cumulative net shares: {data['points'][-1]['cumulative']:,}")

const resp = await fetch(
  "https://lab.flashalpha.com/v1/flow/stocks/SPY/cumulative",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();
console.log("Cumulative net shares: " + data.points[data.points.length-1].cumulative.toLocaleString());

{
  "symbol": "SPY",
  "minutes": 240,
  "count": 240,
  "points": [
    {
      "ts": "2026-10-30T09:44:00Z",
      "netVolume": 207,
      "cumulative": 207,
      "vwap": 762.5057,
      "tradeCount": 8
    },
    {
      "ts": "2026-10-30T09:45:00Z",
      "netVolume": -425,
      "cumulative": -218,
      "vwap": 762.3422,
      "tradeCount": 16
    }
  ],
  "endpoint_version": "2026.09.30",
  "data_as_of": {
    "node": "fa5",
    "equity_feed": "2026-10-30T13:46:03.297Z",
    "equity_options_feed": "2026-10-30T13:46:02Z",
    "index_feed": "2026-10-30T13:46:02.132Z",
    "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"
  }
}

Response Fields

Errors

About

Per-minute net share volume joined with a running cumulative across the window. Drop straight into a single-line accumulation/distribution chart, or use the cumulative path to spot intraday inflection points.

Common Use Cases

• Plot a single-line accumulation/distribution chart - feed points[].cumulative straight into a line series to visualize running net share flow across the window
• Spot flow-vs-price divergence - compare the slope of cumulative against the vwap path to flag when price rises while net flow rolls over (or vice versa)
• Attribute pressure by session - diff cumulative between timestamps to isolate morning vs afternoon directional bias from the per-minute netVolume
• Catch intraday inflections - detect sign flips and slope changes in cumulative to mark where accumulation turns to distribution
• Compare correlated tickers - overlay each symbol's cumulative path for a pairs/relative-flow read
• Confirm participation - weight inflections by tradeCount so thin-volume wiggles do not trigger false signals

Related

Related reading

• Build a dealer-positioning / flow monitor - fold this cumulative net-flow line into a live multi-symbol monitor

Complementary endpoints

• Stocks History - the per-minute buckets (with OHLC) behind this cumulative path
• Stocks Summary - the single-shot net-volume total for the same buffer
• Stocks Bars - OHLCV + flow bars to chart price alongside the cumulative line
• Options Cumulative - the matching running net-flow path for the options tape