Stocks Flow Summary API

Endpoint

Parameters

Request

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/flow/stocks/SPY/summary"

import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/flow/stocks/SPY/summary",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
resp.raise_for_status()
data = resp.json()
print(f"Net share volume: {data['netVolume']:,}")

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

{
  "symbol": "SPY",
  "totalTrades": 1161962,
  "buyVolume": 25528959,
  "sellVolume": 20487729,
  "midVolume": 26936130,
  "netVolume": 5041230,
  "biggestSingleTrade": 2200000,
  "lastTradeUtc": "2026-10-30T13:46:04.6240669Z",
  "endpoint_version": "2026.09.30",
  "data_as_of": {
    "node": "fa4",
    "equity_feed": "2026-10-30T13:46:04.46Z",
    "equity_options_feed": "2026-10-30T13:46:03Z",
    "index_feed": "2026-10-30T13:46:03.107Z",
    "index_options_feed": "2026-10-30T13:46:03Z",
    "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"
  }
}

Response Fields

Errors

About

Aggregated stock-flow totals across the in-memory buffer for a symbol. Volumes are in shares. netVolume is the headline directional pressure indicator for the equity tape.

Common Use Cases

• Headline buy/sell pressure - surface buyVolume vs sellVolume and the signed netVolume as the directional-pressure tile on an equity-tape dashboard
• Rank a watchlist - sort tickers by absolute netVolume to push the most one-sided names to the top of a scanner
• Spot block-driven tape - compare biggestSingleTrade to typical lot size to flag when a single institutional print is moving the totals
• Measure conviction vs noise - weigh netVolume against midVolume to discount sessions where most flow crossed at the mid with no clear aggressor
• Gate on tape freshness - check lastTradeUtc (and its null case) to confirm the name is actively trading before acting on the totals
• Normalize across names - divide netVolume by totalTrades for a per-trade imbalance that compares thin and heavy tapes on the same scale

Related

Related reading

• Build a dealer-positioning / flow monitor - wire these net-volume totals into a multi-symbol flow dashboard
• Options flow API: recent trades, blocks & leaderboard - the parallel summary-and-tape workflow on the options side

Complementary endpoints

• Stocks Recent - drill from the totals into the underlying per-trade tape
• Stocks Leaderboard - the same net-notional ranking across the whole equity universe
• Stocks Cumulative - watch how netVolume accumulates minute-by-minute
• Options Summary - the matching aggregated flow totals for the options tape