com.optionsbell/options-flow

Tools

• get_dataset_stats

  Discover what data is available before querying: date ranges, contract counts, symbol counts and sector coverage for the unusual-activity dataset and its daily aggregates. Call this first when unsure about available history.

  shallow
• get_expiry_concentration

  Where the day's unusual premium sits along the expiry axis, in DTE buckets (0-7, 8-30, 31-90, 90+) with call/put splits. Heavy short-dated premium reads as event bets; heavy long-dated as positioning.

  shallow
• get_flow_history

  End-of-day series of one symbol's UNUSUAL options flow (aggregated from the contracts that passed the unusual filter - not the full tape): daily call/put volume, premium, C/P ratios, average IV, net delta and the consecutive-day streak. ~75 trading days - the series behind back-tests and 'how has unusual flow on NVDA developed?'

  shallow
• get_flow_sentiment

  Bullish/bearish classification of each symbol's unusual flow with a 0-9 strength score, based on call/put volumes, premium and net delta. Pass a symbol for that ticker's sentiment time series; omit it for the cross-market snapshot (filterable by sector or minimum strength).

  shallow
• get_flow_streaks

  Symbols with unusual options activity on N+ consecutive trading days, with the dominant side (call/put). Persistent unusual flow is a stronger signal than a single print - use for 'where does money keep showing up?'

  shallow
• get_iv_rank

  IV rank and IV percentile per symbol against its rolling history (needs 20+ days). Pass a symbol for its IV-rank time series; omit it for a ranked snapshot (e.g. side=put&min_rank=0.8 finds elevated put IV).

  shallow
• get_market_regime

  Market-wide breadth of unusual flow per trading day: breadth score 0-100, aggregate call/put ratio, regime label (bullish/bearish/mixed) and signal counts. Use for 'what's the overall tone of the unusual-flow tape?'

  shallow
• get_oi_changes

  Day-over-day open-interest change per symbol (total, calls, puts) - fresh positioning being built or unwound. Pass a symbol for its OI-change series; omit it for market-wide gainers/losers.

  shallow
• get_sector_flow

  Which GICS sectors the day's unusual options premium is concentrating in: total premium, volume, average net delta and bullish/bearish symbol counts per sector.

  shallow
• get_symbol_flow

  Every unusual contract on a single ticker, sorted by Vol/OI. Use when the question is about one specific stock's unusual options flow.

  shallow
• get_top_prints

  The day's biggest options bets ranked by estimated premium - the same view OptionsBell alert emails lead with. Perfect for 'what were the largest options trades today?'

  shallow
• get_unusual_activity

  Contract-level unusual options activity scan across 7,000+ US stocks (the dataset behind OptionsBell alerts). Filter by symbols, side and thresholds: Vol/OI ratio, premium (USD), IV, days-to-expiration. Rows include strike, expiry, volume, open interest, IV, delta, sector and an estimated premium. Use for questions like 'what unusual put buying hit TSLA today?'

  shallow
• ping

  Liveness check for the OptionsBell MCP server. No API key required.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/81d4ccaf-9804-46d7-8ec0-c71ac73566bc/badge.svg)](https://vouch.tools/servers/81d4ccaf-9804-46d7-8ec0-c71ac73566bc)