Option Contract Minute History API

Endpoint

Parameters

Request

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/flow/options/SPY/option-minute-history?expiry=2026-12-18"

import requests
from collections import defaultdict

resp = requests.get(
    "https://lab.flashalpha.com/v1/flow/options/SPY/option-minute-history",
    params={"expiry": "2026-12-18"},
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
resp.raise_for_status()
data = resp.json()

# net customer flow per strike = sum of (buy - sell) over all minutes
net = defaultdict(int)
for c in data["contracts"]:
    net[c["strike"]] += sum(b["buy"] - b["sell"] for b in c["buckets"])
for strike in sorted(net):
    print(strike, net[strike])

const resp = await fetch(
  "https://lab.flashalpha.com/v1/flow/options/SPY/option-minute-history?expiry=2026-12-18",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();

// net customer flow per strike = sum of (buy - sell) over all minutes
const net = {};
for (const c of data.contracts) {
  for (const b of c.buckets) net[c.strike] = (net[c.strike] || 0) + b.buy - b.sell;
}
console.log(net);

{
  "symbol": "SPY",
  "contracts": [
    {
      "strike": 300,
      "right": "C",
      "expiry": "2026-12-18",
      "buckets": [
        {
          "t": "2026-10-29T13:55:00Z",
          "buy": 0,
          "sell": 0,
          "mid": 1
        },
        {
          "t": "2026-10-29T14:14:00Z",
          "buy": 1,
          "sell": 0,
          "mid": 0
        }
      ]
    },
    {
      "strike": 375,
      "right": "P",
      "expiry": "2026-12-18",
      "buckets": [
        {
          "t": "2026-10-29T15:36:00Z",
          "buy": 2,
          "sell": 0,
          "mid": 0
        }
      ]
    }
  ],
  "endpoint_version": "2026.09.30",
  "data_as_of": {
    "node": "fa5",
    "equity_feed": "2026-10-30T14:15:29.104Z",
    "equity_options_feed": "2026-10-30T14:15:28Z",
    "index_feed": "2026-10-30T14:15:29.102Z",
    "index_options_feed": "2026-10-30T14:15:27Z",
    "futures_feed": "2026-10-30T14:15:28.643Z",
    "futures_options_feed": "2026-10-30T14:15:27.966Z",
    "flow_feed": "2026-10-30T14:15:00Z",
    "oi_feed": "2026-10-29T20:00:00Z",
    "macro_feed": "2026-10-29T21:00:20Z"
  }
}

Responses can exceed 380 KB.

Response Fields

Errors

About

Returns the option tape of an underlying split by contract: for every strike, right and expiry that traded, one bucket per minute with the contracts bought, sold and traded at mid. Sum buy - sell per strike for net customer flow. The inferred dealer inventory change is its negation, sell - buy, accumulating from zero at the 09:30 ET open - a change over the session, never an absolute dealer position.

Without expiry the response covers the whole chain and can be large (SPY: about 4,500 contracts and 7 MB). Filter to one expiry when you only need one cycle. For totals per underlying instead of per contract, use Options Trade History.

Common Use Cases

• Net customer flow by strike - sum buy - sell over every bucket of each strike to see where customers bought or sold options today
• Dealer inventory change by strike - negate the customer flow (sell - buy) to estimate how dealer positioning changed since the open
• Strike x time heatmap - plot per-minute net flow for each strike to see when and where activity concentrated
• One expiry cycle - pass expiry to follow flow into a single OPEX or weekly without downloading the full chain
• Calls vs puts - split by right to compare call and put buying at the same strike

Related

Related reading

• Options flow API: recent trades, blocks & leaderboard - how the raw tape endpoints fit together end to end

Complementary endpoints

• Options Trade History - the same minute flow rolled up per underlying, with VWAP and high/low
• Options Recent Trades - the individual prints behind each bucket
• Flow GEX - ?polarity=flow signs each strike by the dealer inventory change inferred from the tape
• 0DTE Strike Flow - per-strike signed aggressor flow for the same-day expiry