OptionWhales
OnlineUS options flow & stock data: unusual activity, gamma levels, IV, earnings. OAuth sign-in or keys.
What it can do: 37 tools
intent_flow_currentread-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 optionsmomentum_rankingsread-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_currentread-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 trdirectional_currentread-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_tideread-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 overallsector_tideread-onlyOptions net premium aggregated by sector for a session. Use for 'which sectors are seeing bullish options flow?'. Pro.darkpool_rankingread-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_profileread-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_currentread-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_calendarread-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 andearnings_calendarread-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_levelsread-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 updatedgreek_exposureread-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_structureread-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 kvolatility_moversread-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_moversread-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_timeseriesread-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_chainread-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_atmread-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_historicread-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_quoteread-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_candlesread-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_indicatorread-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.financialsread-onlyCompany financial statements (income statement, balance sheet, cash flow) for trailing-twelve-month, quarterly or annual periods, latest first. Pro.dividendsread-onlyCash dividend history for a stock: amount, frequency, ex-dividend and pay dates. Pro.stock_splitsread-onlyStock split history for a ticker: execution date and split ratio. Pro.stock_newsread-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_interestread-onlyFINRA short interest history (bi-weekly settlements) with days to cover for a stock. Use for 'how heavily shorted is GME?'. Pro.short_volumeread-onlyDaily FINRA short-sale volume and short-volume ratio for a stock, with per-venue split. Pro.insider_tradesread-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.seasonalityread-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.screenerread-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; sortregister_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 tconfirm_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_marketread-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 strengabsorption_tickerread-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 mcp add --transport http optionwhales https://api.optionwhales.io/mcpSettings → Connectors → Add custom connector
URL: https://api.optionwhales.io/mcp{
"mcpServers": {
"optionwhales": {
"url": "https://api.optionwhales.io/mcp"
}
}
}{
"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
-
TipRanksOnlineOfficial
Live TipRanks market data: analyst ratings, Smart Score, technicals, options, portfolios.
-
GoCardless MCP ServerOnline · sign-in requiredOfficial
Manage GoCardless payments, mandates, subscriptions, refunds and payouts via AI assistants.
-
Avalara AvaTaxOnline · sign-in requiredOfficial
Access Avalara AvaTax API for tax calculation, transactions, nexus management, and compliance
-
Avalara ReturnsOnline · sign-in requiredOfficial
Provides access to Avalara Global Returns API for tax returns, filing calendars, and compliance data
-
Avalara Tax ContentOnline · sign-in requiredOfficial
Provides access to Avalara Tax Content: TTE configs, jobs, communications, lodging, autorental
-
Avalara Tax Registrations and Business LicensesOnline · sign-in requiredOfficial
Provides access to Avalara Tax Registration and Business Licenses APIs for filings and registrations