Agents Index

OptionWhales

Online

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

Visit publisherConnectJSON

What it can do: 37 tools

  • intent_flow_current read-onlyToday's options-flow intent rankings: which tickers show bullish vs bearish large-order positioning signals (accumulation, distribution, hedging), with direction bias and strength. Use for 'what does large-order options
  • momentum_rankings read-onlyTickers 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.
  • abnormal_trades_current read-onlyUnusual 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 'latest unusual options tr
  • directional_current read-onlyPer-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.
  • market_tide read-onlyMarket-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
  • sector_tide read-onlyOptions net premium aggregated by sector for a session. Use for 'which sectors are seeing bullish options flow?'. Pro.
  • darkpool_ranking read-onlyOff-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_profile read-onlyWHEN 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 (
  • earnings_current read-onlyOptions 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_calendar read-onlyUpcoming 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
  • earnings_calendar read-onlyUpcoming 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:
  • gex_levels read-onlyModeled dealer gamma-exposure key levels for a ticker: gamma flip, max pain, call wall, put wall and spot. When timestamps are present, calculated levels belong to the options snapshot at computed_at; spot may be updated
  • greek_exposure read-onlyDealer 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.
  • volatility_term_structure read-onlyAt-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 k
  • volatility_movers read-onlyTickers 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.
  • oi_movers read-onlyTickers 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_timeseries read-onlyOpen interest and volume across recent snapshots for one ticker (calls, puts, total). Use to see whether options positioning is building or unwinding. Pro.
  • contract_chain read-onlyOption 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_atm read-onlyNear-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_historic read-onlyDaily OHLC price bars for one option contract by OCC symbol (e.g. SPY260130C00600000) between two dates, about a year of look-back. Pro.
  • stock_quote read-onlyLatest 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_candles read-onlyIntraday 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.
  • technical_indicator read-onlyTechnical 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.
  • financials read-onlyCompany financial statements (income statement, balance sheet, cash flow) for trailing-twelve-month, quarterly or annual periods, latest first. Pro.
  • dividends read-onlyCash dividend history for a stock: amount, frequency, ex-dividend and pay dates. Pro.
  • stock_splits read-onlyStock split history for a ticker: execution date and split ratio. Pro.
  • stock_news read-onlyRecent news for a ticker, each article with a pre-computed sentiment (positive, negative, neutral) and its reasoning. Use for 'why is TSLA moving?'. Pro.
  • short_interest read-onlyFINRA short interest history (bi-weekly settlements) with days to cover for a stock. Use for 'how heavily shorted is GME?'. Pro.
  • short_volume read-onlyDaily FINRA short-sale volume and short-volume ratio for a stock, with per-venue split. Pro.
  • insider_trades read-onlySEC 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.
  • seasonality read-onlyMonthly 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.
  • screener read-onlyScreen 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
  • register_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 t
  • confirm_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.
  • use_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.
  • absorption_market read-onlyWHICH tickers are having their order flow ABSORBED right now - large flow moving price less than the continuous-tape Kyle-lambda model explains - for a date (default latest): one row per ticker with the absorption streng
  • absorption_ticker read-onlyOne ticker's absorption events for a date (default latest) PLUS its trailing per-day direction history, so you can tell whether today is unusual for the name. Each event carries the absorption strength percentile, the si

Connect it

Claude Code
claude mcp add --transport http optionwhales https://api.optionwhales.io/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://api.optionwhales.io/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "optionwhales": {
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "optionwhales": {
      "type": "http",
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}

Questions

What does OptionWhales do?

US options flow & stock data: unusual activity, gamma levels, IV, earnings. OAuth sign-in or keys. It exposes 37 tools to AI assistants.

What tools does OptionWhales provide?

37 tools, including intent_flow_current, momentum_rankings, abnormal_trades_current, directional_current, market_tide, sector_tide, darkpool_ranking, darkpool_time_profile, earnings_current, economic_calendar, earnings_calendar, gex_levels….

How do I connect OptionWhales to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://api.optionwhales.io/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does OptionWhales require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is OptionWhales online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes OptionWhales?

optionwhales.io. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Finance & Payments