Options Recent Trades API

Endpoint

Parameters

Request

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

import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/flow/options/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/options/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",
  "expiry": null,
  "count": 10,
  "totalAvailable": 5145,
  "trades": [
    {
      "ts": "2026-10-30T13:45:58.448Z",
      "instrumentId": 1375734148,
      "expiry": "2026-11-02",
      "strike": 761,
      "right": "P",
      "price": 3.74,
      "size": 8,
      "side": "mid",
      "vendorSide": "none",
      "isBlock": false,
      "bid": 3.73,
      "ask": 3.76
    },
    {
      "ts": "2026-10-30T13:45:58.432Z",
      "instrumentId": 1375734056,
      "expiry": "2026-10-30",
      "strike": 763,
      "right": "C",
      "price": 0.84,
      "size": 20,
      "side": "buy",
      "vendorSide": "none",
      "isBlock": false,
      "bid": 0.83,
      "ask": 0.84
    }
  ],
  "endpoint_version": "2026.09.30",
  "data_as_of": {
    "node": "fa5",
    "equity_feed": "2026-10-30T13:45:58.488Z",
    "equity_options_feed": "2026-10-30T13:45:58Z",
    "index_feed": "2026-10-30T13:45:58.107Z",
    "index_options_feed": "2026-10-30T13:45:57Z",
    "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 trades[]

Errors

About

Returns the most recent option trades for an underlying across all of its contracts in a single stream, newest first. Trades come from the in-memory buffer fed by the ingest service, and totalAvailable reports how deep that buffer currently is. Useful for a live time-and-sales feed or for sampling the most recent activity on a name.

Common Use Cases

• Render a live time-and-sales feed - stream the newest trades[] rows (ts, strike, right, price, size) into a tape widget for a watched symbol
• Read buy/sell pressure at a glance - tally side (buy vs sell vs mid) across recent prints to judge whether the tape is aggressively bid or offered right now
• Flag institutional prints - filter isBlock=true rows to surface large single-ticket trades the moment they cross
• Classify aggressor side from quotes - compare price against bid/ask to confirm whether a fill lifted the offer or hit the bid for sweep/toxic-flow detection
• Gauge tape depth - watch totalAvailable versus count to see how active a name is and how far back the in-memory buffer reaches
• Feed downstream classifiers - sample the latest trades by instrumentId and expiry to seed real-time sweep, repeat-hitter, or unusual-activity models

Related

Related reading

• Options flow API: recent trades, blocks & leaderboard - how the raw tape endpoints fit together end to end
• Flow Signals API: scoring unusual options activity - turn raw prints into a ranked unusual-activity score

Complementary endpoints

• Options Blocks - isolate only the large block and sweep prints from the same tape
• Options Summary - aggregate the tape into call/put and buy/sell totals
• Options Leaderboard - rank the most-active contracts behind these prints
• Flow Signals - scored unusual-activity layer built on this raw flow