Skip to content
Agentmart
Submit a tool

OptionWhales

US options flow & stock data: unusual activity, gamma levels, IV, earnings.

Connector by optionwhales.ioOfficial · Domain verified by the MCP Registry

IndexedLicense unknownRemote (HTTP)
Write a review

Chalk Labs

Need help deploying OptionWhales?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/optionwhales-io-options-flow

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoints

  • https://api.optionwhales.io/mcp Remote (HTTP)
  • https://api.optionwhales.io/mcp/connect Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

US options flow & stock data: unusual activity, gamma levels, IV, earnings. OAuth sign-in or keys.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
32 read · 3 write · 0 delete
Secrets
1 (API keys, tokens or passwords)
Install scripts
Nothing to install (hosted)
Runs as
Hosted (remote endpoint)

Tools by what they do 35

From the running server's own tool list (tools/list) on Oct 25, 2026.

Read 32 · Look things up without changing anything.

  • abnormal_trades_current
  • contract_atm
  • contract_chain
  • contract_historic
  • darkpool_ranking
  • darkpool_time_profile
  • directional_current
  • dividends
  • earnings_calendar
  • earnings_current
  • economic_calendar
  • financials
Show 20 more tools
  • gex_levels
  • greek_exposure
  • insider_trades
  • intent_flow_current
  • market_tide
  • momentum_rankings
  • oi_movers
  • oi_timeseries
  • screener
  • seasonality
  • sector_tide
  • short_interest
  • short_volume
  • stock_candles
  • stock_news
  • stock_quote
  • stock_splits
  • technical_indicator
  • volatility_movers
  • volatility_term_structure

Write 3 · Create, change, send or run things.

  • confirm_registration
  • register_free_key
  • use_api_key

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • X-API-Key

Network hosts it talks to 1

  • api.optionwhales.io · found in remote endpoint, install command

Tools (35)

As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • abnormal_trades_currentUnusual options activityread-only

    Unusual 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); free: the latest 5 with core fields; Pro: the full feed.

  • confirm_registrationConfirm a free API key

    Confirm 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.

  • contract_atmAt-the-money option strikesread-only

    Near-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.

  • contract_chainOption chainread-only

    Option 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.

  • contract_historicOption contract price historyread-only

    Daily OHLC price bars for one option contract by OCC symbol (e.g. SPY260130C00600000) between two dates, about a year of look-back. Pro.

  • darkpool_rankingDark pool rankingread-only

    Off-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.

  • darkpool_time_profileDark pool time profileread-only

    WHEN one ticker's off-exchange (dark pool) volume traded, by price, for a date (default latest): a 5-minute × price grid of shares, the point of control and value area, and the largest block prints at their report time (outside_nbbo flags prints reported beyond the quote, away_from_quote those priced away from it: >0.1% and 2 cents outside). cells_side gives each cell's [buy, sell, away] shares (buy = at the ask + 60% near it, sell = at the bid + 60% near it, away left out, rest neutral); totals add buy_volume, sell_volume, away_volume. Side is an NBBO-location proxy, not buy/sell; ~15 min del…

  • directional_currentDirectional score by tickerread-only

    Per-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.

  • dividendsDividend historyread-only

    Cash dividend history for a stock: amount, frequency, ex-dividend and pay dates. Pro.

  • earnings_calendarEarnings calendarread-only

    Upcoming 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 estimates; Pro: the full calendar plus the options-flow intent label.

  • earnings_currentEarnings options positioningread-only

    Options 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.

  • economic_calendarEconomic calendarread-only

    Upcoming 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.

  • financialsCompany financialsread-only

    Company financial statements (income statement, balance sheet, cash flow) for trailing-twelve-month, quarterly or annual periods, latest first. Pro.

  • gex_levelsGamma exposure (GEX) levelsread-only

    Dealer gamma-exposure key levels for a ticker: gamma flip, max pain, call wall, put wall and spot. Call wall = the strike at/above spot with the largest call gamma, put wall = the strike at/below spot with the largest put gamma; max pain is struck per expiration and max_pain_expiry names the (front) expiry it belongs to — max_pain_basis / wall_basis say which definition each field carries. 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; Pro: any ti…

  • greek_exposureDealer greek exposureread-only

    Dealer 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.

Show 20 more tools
  • insider_tradesInsider tradesread-only

    SEC 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.

  • intent_flow_currentOptions flow intent rankingsread-only

    Today'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 (ticker, intent, direction); free: top 3 with core fields; Pro: every tracked ticker with all fields.

  • market_tideMarket options tideread-only

    Market-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.

  • momentum_rankingsOptions flow momentum rankingsread-only

    Tickers 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.

  • oi_moversOpen interest moversread-only

    Tickers 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.

  • oi_timeseriesOpen interest historyread-only

    Open interest and volume across recent snapshots for one ticker (calls, puts, total). Use to see whether options positioning is building or unwinding. Pro.

  • register_free_keyGet a free API key

    Get 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 sessions. OptionWhales emails them 'Confirm your OptionWhales API key' with a confirmation code: if you can read their inbox, call confirm_registration with that code; otherwise ask them to click the link. Once confirmed the key is permanent (and Pro if their account is Pro).

  • screenerMulti-signal stock screenerread-only

    Screen 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 the next 30 days'. Pro.

  • seasonalityMonthly seasonalityread-only

    Monthly 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.

  • sector_tideSector options tideread-only

    Options net premium aggregated by sector for a session. Use for 'which sectors are seeing bullish options flow?'. Pro.

  • short_interestShort interestread-only

    FINRA short interest history (bi-weekly settlements) with days to cover for a stock. Use for 'how heavily shorted is GME?'. Pro.

  • short_volumeDaily short volumeread-only

    Daily FINRA short-sale volume and short-volume ratio for a stock, with per-venue split. Pro.

  • stock_candlesStock intraday candlesread-only

    Intraday 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.

  • stock_newsStock news with sentimentread-only

    Recent news for a ticker, each article with a pre-computed sentiment (positive, negative, neutral) and its reasoning. Use for 'why is TSLA moving?'. Pro.

  • stock_quoteStock quoteread-only

    Latest 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.

  • stock_splitsStock split historyread-only

    Stock split history for a ticker: execution date and split ratio. Pro.

  • technical_indicatorTechnical indicatorread-only

    Technical 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.

  • use_api_keyUse an existing API key

    Attach 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.

  • volatility_moversImplied volatility moversread-only

    Tickers 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.

  • volatility_term_structureImplied volatility term structureread-only

    At-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.

Signals

Last release
Oct 3, 2026 (1 month ago)

Details

Registry name
io.optionwhales/options-flow
Version
1.4.0
Auth
API key, Auth not stated
License
License unknown
Website
optionwhales.io/for-ai-agents
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registry

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped
50+
launches shipped
media placements
500+
media placements
founders on every account
2
founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get OptionWhales running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Goes to the Chalk Labs founders, not the newsletter. Privacy

Need help deploying OptionWhales?

CallGet help
Cite this page

OptionWhales MCP server. Agent Mart. https://agentmart.dev/connectors/optionwhales-io-options-flow (last updated 2026-10-24)