Stocks Cumulative Net Flow API

Endpoint

GET /v1/flow/stocks/{symbol}/cumulative

Auth required (X-Api-Key) Rate Limited: Yes Alpha plan+

Parameters

Name	In	Required	Default	Description
`symbol`	path	yes	-	Stock symbol
`minutes`	query	no	240	Window size, clamped to `1..10080`

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"}
)
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" } }
);
const data = await resp.json();
console.log("Cumulative net shares: " + data.points[data.points.length-1].cumulative.toLocaleString());

API Key

Response

{
  "symbol": "SPY",
  "minutes": 240,
  "count": 3,
  "points": [
    {
      "ts": "2026-05-12T15:00:00Z",
      "netVolume": 38200,
      "cumulative": 38200,
      "vwap": 596.42,
      "tradeCount": 7045
    },
    {
      "ts": "2026-05-12T15:01:00Z",
      "netVolume": -12480,
      "cumulative": 25720,
      "vwap": 596.38,
      "tradeCount": 6980
    },
    {
      "ts": "2026-05-12T15:02:00Z",
      "netVolume": 45150,
      "cumulative": 70870,
      "vwap": 596.51,
      "tradeCount": 7210
    }
  ]
}

Key Response Fields

Field	Type	Description
`symbol`	string	Uppercase stock symbol
`minutes`	integer	Requested/effective minute window
`count`	integer	Number of points returned
`points[]`	array	Cumulative flow points: `ts`, `netVolume`, `cumulative`, `vwap`, `tradeCount`

Errors

Status	Description
`403`	Requires Alpha plan or higher
`502`	Upstream flow data source unavailable

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

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