Stocks Recent Trades API

Endpoint

Parameters

Request

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/flow/stocks/SPY/recent?limit=10"

import requests

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

const resp = await fetch(
  "https://lab.flashalpha.com/v1/flow/stocks/SPY/recent",
  { 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 + " of " + data.totalAvailable + " buffered trades");

{
  "symbol": "SPY",
  "count": 3,
  "totalAvailable": 3,
  "trades": [
    {
      "ts": "2026-10-30T13:46:04.5470833Z",
      "price": 760.21,
      "size": 159,
      "side": "buy",
      "isBlock": false,
      "bid": 760.19,
      "ask": 760.21
    },
    {
      "ts": "2026-10-30T13:46:04.5138083Z",
      "price": 760.2,
      "size": 2,
      "side": "mid",
      "isBlock": false,
      "bid": 760.19,
      "ask": 760.22
    }
  ],
  "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

Returns the most recent equity trades for a symbol, newest first. side is bid-ask side classification, and isBlock marks prints above the block threshold.

Common Use Cases

• Render a live time-and-sales feed - stream trades[] newest-first, coloring each row by side (buy/sell/mid) to show aggressor flow on an equity ticker
• Estimate slippage from the spread - pair each price with the prevailing bid/ask on the same row to measure how far through the quote the print executed
• Alert on institutional prints - filter on isBlock to fire a notification the moment a trade clears the block-size threshold
• Backfill a chart or replay buffer - pull the last N rows with limit (up to 500) and use totalAvailable to know how deep the in-memory buffer goes
• Classify aggressor pressure - bucket size by side over the returned window to gauge whether buyers or sellers are lifting offers vs hitting bids
• Gate on tape freshness - read the newest ts against wall clock to confirm the name is actively trading before acting on a signal

Related

Related reading

• Options flow API: recent trades, blocks & leaderboard - the matching trade-tape workflow on the options side of the same pipeline
• Real-time options data: polling vs streaming - how to poll this buffer efficiently for a low-latency tape

Complementary endpoints

• Stocks Summary - collapse the same tape into headline buy/sell/net totals
• Stocks Blocks - the same prints pre-filtered to block size
• Stocks Bars - roll these trades into OHLCV + flow candles
• Options Recent - the matching per-trade options tape for the same symbol