options-flow

Tools

34 tools: 31 read-only, 2 change data, 1 high risk (delete, pay, send or run code).

No tool name points to moving money or changing orders.

read-only

Only reads or looks things up. Safe for an agent to call on its own.

changes data

Creates, edits or sends something. Worth a person's approval the first time.

high risk

Can delete, pay, send on your behalf or run code. Hard or impossible to undo.

Connecting costs an agent about 6,185 tokens of tool definitions and a 362 ms handshake.

• high riskuse_api_keyAttach an existing OptionWhales API key to this MCP session, for clients that cannot send an X-API-Key header. Use when the person gives you their key.
• changes dataregister_free_keyGet a FREE OptionWhales API key for the person you are helping. Only use this if they do not already have a key. Pass their own email address (ask if unsure). The key in the response works immediately for 24 hours, and this MCP session starts using it automatically when the client supports sessio...
• changes dataconfirm_registrationConfirm a key from register_free_key using the code in the 'Confirm your OptionWhales API key' email, which makes the key permanent. Safe to call again.
• read-onlyintent_flow_currentToday's options-flow intent rankings: which tickers show bullish vs bearish institutional positioning (accumulation, distribution, hedging), with direction bias and strength. Use for 'what are big options traders doing today?' or 'where is smart money flowing?'. Without an account: top 3 tickers ...
• read-onlymomentum_rankingsTickers ranked by options-flow momentum (the fastest-changing positioning this session). Use for 'which stocks have the strongest options momentum right now?'. Free keys: top 3; Pro: up to 200 with all fields.
• read-onlyabnormal_trades_currentUnusual options activity this session - large, sweep-like or volume-versus-open-interest outlier orders with ticker, direction, size and time. Use for 'any unusual options activity in NVDA?' or 'biggest options trades today'. Without an account: the latest 3 trades (ticker, direction, type, time)...
• read-onlydirectional_currentPer-ticker directional score for this session (-1 bearish to +1 bullish) combining net premium, order clustering and implied volatility. Use to rank names by bullish or bearish options positioning. Pro.
• read-onlymarket_tideMarket-wide options net-premium 'tide': signed large-order premium into calls versus puts, its intraday cumulative curve, and the top net-premium tickers for a session. Use for 'is options flow bullish or bearish overall today?'. Pro.
• read-onlysector_tideOptions net premium aggregated by sector for a session. Use for 'which sectors are seeing bullish options flow?'. Pro.
• read-onlydarkpool_rankingOff-exchange (dark pool) activity: the market-wide off-exchange share and a per-ticker ranking by off-exchange notional for a date (default latest). Use for 'where is dark pool activity concentrated?'. Pro.
• read-onlyearnings_currentOptions positioning around earnings for companies reporting this session: pre-earnings order flow, Greeks and intent signals. Use for 'how are traders positioned into NVDA earnings?'. Pro.
• read-onlyeconomic_calendarUpcoming US economic events (CPI, FOMC, jobs, GDP and more) with impact level and the ETFs that historically react. Use for 'what macro events are coming up?'. Without an account: the next 3 high-impact events; free and Pro: the full calendar.
• read-onlyearnings_calendarUpcoming earnings reports: date, before/after market, EPS and revenue estimates. Pass a ticker for 'when does NVDA report?', or omit it for 'who reports this week?' (days sets the window, default 7). Without an account: date and time for one ticker or the next 3 reporters; free: up to 10 with est...
• read-onlygex_levelsDealer gamma-exposure key levels for a ticker: gamma flip, max pain, call wall, put wall and spot. Use when asked where price may pin, bounce, stall or accelerate, e.g. 'what are the gamma levels on SPY?'. session defaults to the latest trading day. Without an account and on free: SPY and QQQ; Pr...
• read-onlygreek_exposureDealer gamma, charm and vanna exposure for a ticker, by strike and by expiry (calls, puts, net). Use for detailed hedging-flow analysis beyond the key GEX levels. session defaults to the latest trading day. Pro.
• read-onlyvolatility_term_structureAt-the-money implied volatility by expiration (the IV term structure), plus spot and the overall ATM IV for a ticker. Use for 'is NVDA implied volatility elevated?' or 'is the vol curve inverted before earnings?'. Free keys: SPY, QQQ, AAPL, MSFT, GOOGL, AMZN, NVDA, META, TSLA; Pro: any ticker.
• read-onlyvolatility_moversTickers whose 30-day at-the-money implied volatility moved most versus the prior close (expansions and/or compressions). Use for 'which stocks saw the biggest IV spikes today?'. Free keys: top 3; Pro: up to 50.
• read-onlyoi_moversTickers ranked by day-over-day change in total options open interest (top gainers, losers, most active). Use for 'where is new options positioning building?'. Pro.
• read-onlyoi_timeseriesOpen interest and volume across recent snapshots for one ticker (calls, puts, total). Use to see whether options positioning is building or unwinding. Pro.
• read-onlycontract_chainOption chain for a ticker from the latest open-interest snapshot: each contract's OCC symbol, strike, expiry, type and open interest (OI > 0). Filter by expiry, call/put or minimum OI. Pro.
• read-onlycontract_atmNear-the-money option strikes grouped by expiry, within a band around spot (default plus or minus 5%). Use to find the liquid at-the-money contracts for a ticker. Pro.
• read-onlycontract_historicDaily OHLC price bars for one option contract by OCC symbol (e.g. SPY260130C00600000) between two dates, about a year of look-back. Pro.
• read-onlystock_quoteLatest price for a stock or ETF. Real-time for symbols on your key's real-time watchlist; otherwise the most recent price at least 15 minutes old. Use for 'what is NVDA trading at?'. Pro.
• read-onlystock_candlesIntraday OHLCV bars for a stock on a session (default today), 1 to 60 minute bars; returns the most recent `limit` bars. Live bars are real-time for watchlisted symbols and 15 minutes delayed otherwise. Pro.
• read-onlytechnical_indicatorTechnical indicator series for a stock: SMA, EMA, RSI or MACD on adjusted closes (daily by default), latest first. Use for 'is AAPL overbought?' (RSI) or trend questions. Pro.
• read-onlyfinancialsCompany financial statements (income statement, balance sheet, cash flow) for trailing-twelve-month, quarterly or annual periods, latest first. Pro.
• read-onlydividendsCash dividend history for a stock: amount, frequency, ex-dividend and pay dates. Pro.
• read-onlystock_splitsStock split history for a ticker: execution date and split ratio. Pro.
• read-onlystock_newsRecent news for a ticker, each article with a pre-computed sentiment (positive, negative, neutral) and its reasoning. Use for 'why is TSLA moving?'. Pro.
• read-onlyshort_interestFINRA short interest history (bi-weekly settlements) with days to cover for a stock. Use for 'how heavily shorted is GME?'. Pro.
• read-onlyshort_volumeDaily FINRA short-sale volume and short-volume ratio for a stock, with per-venue split. Pro.
• read-onlyinsider_tradesSEC Form 4 insider transactions for a stock, latest first: insider, transaction code, shares, price, value and the SEC filing link. Use for 'are insiders buying AAPL?'. Pro.
• read-onlyseasonalityMonthly seasonality for a stock: average and median return by calendar month, hit rate, best and worst years over a 1 to 25 year look-back. Pro.
• read-onlyscreenerScreen the market across options-flow net premium, open-interest change, FDA catalysts and congressional trading. Filter by direction, minimum premium or OI change, catalyst window, trial phase or congress activity; sort and limit. Use for 'find bullish options-flow names with an FDA catalyst in ...

Levels are read from each tool's name, description and annotations. Descriptions as the server publishes them.

Status

Newest check: answered with tools, from the daily check, 2026-10-03, 362 ms.

From one check a day over the last 1 day. Servers whose owner verified them are checked every 5 minutes. Sign-in and payment answers count as up.

Last 30 days

2026-09-042026-10-03

answered with toolssign-in or payment askednot answeringnot checked

Compare: the most reliable servers in Online store and commerce, ranked by days answering.

Badge

Live: status, days reachable, the tokens its tool list costs an agent. For a README:

[![7Maps](https://7it.co.il/7maps/badge/api.optionwhales.io/mcp.svg)](https://7it.co.il/7maps/s/api.optionwhales.io/mcp)

Other styles: add ?style=uptime (30-day uptime), ?style=stars (agents’ rating) or ?style=verified (owner mark) to the image address, or ?style=top (shows "top 10%" when the server ranks in the top tenth of its category by days answering; otherwise the standard badge).

Own this server? Verify that it is yours.

Status widget

A live status card for a status page, docs or a dashboard: current status, the 30-day strip, uptime and handshake time.

Script (renders where it is placed, in its own shadow DOM):

<script src="https://7it.co.il/7maps/widget/api.optionwhales.io/mcp.js" async></script>

Or an iframe:

<iframe src="https://7it.co.il/7maps/widget/api.optionwhales.io/mcp" title="7Maps status" width="360" height="176" style="border:0;max-width:100%" loading="lazy"></iframe>

Add ?theme=light or ?theme=dark to either address (default: follows the visitor's setting). Refreshed every 5 minutes. Open the card · script.

For AI agents

Before connecting, an agent can ask 7Maps for this server's full condition, every tool's risk level and what changed since a person approved it: the road_conditions, watch and route tools on https://7it.co.il/7maps/mcp, paid per call in USDC via x402. About 7Maps.