Stocks Flow Minute History API

Endpoint

Parameters

Request

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

import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/flow/stocks/SPY/history",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
resp.raise_for_status()
data = resp.json()
print(f"{data['count']} buckets over {data['minutes']} minutes")

const resp = await fetch(
  "https://lab.flashalpha.com/v1/flow/stocks/SPY/history",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();
console.log(data.count + " buckets over " + data.minutes + " minutes");

{
  "symbol": "SPY",
  "minutes": 120,
  "count": 120,
  "buckets": [
    {
      "ts": "2026-10-30T13:45:00Z",
      "buyVolume": 2329,
      "sellVolume": 4083,
      "midVolume": 1506,
      "netVolume": -1754,
      "tradeCount": 121,
      "biggestTrade": 1960,
      "vwap": 760.1278,
      "open": 760.122,
      "close": 760.25,
      "high": 760.4631,
      "low": 760.05
    },
    {
      "ts": "2026-10-30T13:44:00Z",
      "buyVolume": 5569,
      "sellVolume": 6261,
      "midVolume": 23154,
      "netVolume": -692,
      "tradeCount": 978,
      "biggestTrade": 2560,
      "vwap": 760.2039,
      "open": 760.105,
      "close": 760.13,
      "high": 760.5278,
      "low": 760.02
    }
  ],
  "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

Fields of buckets[]

Errors

About

Minute-aggregated equity trade-flow buckets, newest first. Includes full minute OHLC so this stream can also act as a 1-minute candle feed with flow attribution baked in. Window is clamped to one week.

Common Use Cases

• Draw minute candles with a flow overlay - plot each bucket's open/high/low/close as a candle and shade by buyVolume vs sellVolume for flow-attributed bars in one call
• Track VWAP deviation - measure each bucket's close against its vwap to build a rolling mean-reversion signal
• Scan for volume spikes - flag buckets where tradeCount or biggestTrade jumps above a rolling baseline to catch sudden participation
• Chart cumulative imbalance - sum netVolume across buckets for a session-long accumulation/distribution line
• Feed a backtest - replay 1-minute equity flow buckets (window clamped to one week) alongside option flow for joint signal research
• Discount mid-heavy minutes - weigh netVolume against midVolume to avoid over-reading bars where most volume crossed at the mid

Related

Related reading

• Real-time options data: polling vs streaming - how often to poll a newest-first minute series for a live feed

Complementary endpoints

• Stocks Bars - multi-resolution OHLCV bars (oldest-first) for live chart consumers
• Stocks Cumulative - the running net-volume path over the same window
• Stocks Recent - the per-trade tape these minute buckets aggregate
• Options History - the matching minute-flow buckets for the options tape