Per-contract volume vs rolling baseline (unusual options activity)
Derived endpoint that flags contracts whose current per-contract volume materially exceeds the contract's own rolling average across the last baseline_window_days dated snapshots. Walks the latest B6 snapshot's per-contract volumes; for each contract (both calls and puts) computes baseline_avg = mean(volume across days the contract appeared with positive volume) and flags rows where current_volume / baseline_avg > threshold. Per-row output carries OSI contract symbol + strike + expiry + current volume + baseline + ratio + supplementary Greeks (delta + IV). Sorted by ratio DESC; truncated to limit. Use case: UC-4 Insider + Options Flow Confluence - bullish skew detection in concert with Form 4 insider purchases.
Path parameters
Underlier ticker.
Underlier ticker.
Query parameters
Volume-ratio threshold for the unusual flag (1.5..50). Default 3.0 = 3x the contract's rolling average.
Volume-ratio threshold for the unusual flag (1.5..50). Default 3.0 = 3x the contract's rolling average.
Maximum flagged contracts returned (1..200).
Maximum flagged contracts returned (1..200).
Rolling baseline window in calendar days (5..90). Defaults to 30. Bounded by 90-day retention.
Rolling baseline window in calendar days (5..90). Defaults to 30. Bounded by 90-day retention.
Minimum current-snapshot volume for a contract to be evaluated (filters illiquid deep-OTM strikes).
Minimum current-snapshot volume for a contract to be evaluated (filters illiquid deep-OTM strikes).
Minimum baseline coverage (days the contract appeared with positive volume) required for a contract to qualify. Contracts below this floor land in contracts_excluded_no_baseline.
Minimum baseline coverage (days the contract appeared with positive volume) required for a contract to qualify. Contracts below this floor land in contracts_excluded_no_baseline.
Response
Unusual options activity payload.
Example response
{
"data": {
"symbol": "AAPL",
"snapshot_date": "2026-05-19",
"underlier_price": 187.45,
"threshold": 3,
"baseline_window_days": 30,
"baseline_snapshots_loaded": 28,
"min_volume": 100,
"min_baseline_days": 5,
"contracts_evaluated": 487,
"contracts_excluded_no_baseline": 42,
"unusual_count": 12,
"unusual_contracts": [
{
"contract_symbol": "AAPL260606C00200000",
"option_type": "C",
"strike": 200,
"expiry": "2026-06-06",
"current_volume": 15000,
"baseline_avg_volume": 1200.5,
"baseline_days_count": 25,
"volume_ratio": 12.49,
"open_interest": 8000,
"implied_volatility": 0.42,
"delta": 0.35
}
],
"data_source": "cboe_options_direct",
"as_of": "2026-05-23T22:50:34Z"
},
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}