MCPサーバー

OptionWhales

            io.optionwhales/options-flow
        

データ・分析金融・投資公開・接続可能 MCP 2025-11-25

このMCPでできること

Provides US stock and options data including unusual flow, option chains, gamma and Greek exposure, earnings, financials, short interest, news, and market screens.

abnormal_trades_current

Unusual options activity

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 5000, 'minimum': 1, 'description': 'Trades to return (default 100)'}}, 'additionalProperties': False}

confirm_registration

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

冪等

入力スキーマ

{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': 'Confirmation code from the email'}}, 'additionalProperties': False}

contract_atm

At-the-money option strikes

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'date': {'type': 'string', 'description': 'Snapshot date YYYY-MM-DD (default latest)'}, 'width': {'type': 'number', 'maximum': 0.5, 'minimum': 0.001, 'description': 'Strike band as a fraction of spot (default 0.05)'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

contract_chain

Option chain

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'date': {'type': 'string', 'description': 'Snapshot date YYYY-MM-DD (default latest)'}, 'type': {'enum': ['call', 'put'], 'type': 'string'}, 'limit': {'type': 'integer', 'maximum': 10000, 'minimum': 1, 'description': 'Contracts to return (default 500)'}, 'expiry': {'type': 'string', 'description': 'One expiry, YYYY-MM-DD'}, 'min_oi': {'type': 'integer', 'minimum': 0}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

contract_historic

Option contract price history

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

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['occ', 'from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'YYYY-MM-DD'}, 'occ': {'type': 'string', 'description': 'OCC option symbol, e.g. SPY260130C00600000'}, 'from': {'type': 'string', 'description': 'YYYY-MM-DD'}}, 'additionalProperties': False}

darkpool_ranking

Dark pool ranking

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {'date': {'type': 'string', 'description': 'YYYY-MM-DD (default latest)'}}, 'additionalProperties': False}

directional_current

Directional score by ticker

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {'max_display': {'type': 'integer', 'maximum': 500, 'minimum': 10, 'description': 'Tickers to return (default 100)'}}, 'additionalProperties': False}

dividends

Dividend history

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

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Dividends to return (default 20)'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

earnings_calendar

Earnings calendar

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {'days': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Days ahead to return (default 7)'}, 'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Reporters to return (default 10)'}, 'ticker': {'type': 'string', 'description': 'Optional ticker, e.g. NVDA'}}, 'additionalProperties': False}

earnings_current

Earnings options positioning

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {}, 'additionalProperties': False}

economic_calendar

Economic calendar

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {'impact': {'type': 'string', 'description': 'Optional filter: high, medium or low'}}, 'additionalProperties': False}

financials

Company financials

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

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'maximum': 40, 'minimum': 1, 'description': 'Periods to return (default 4)'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}, 'timeframe': {'enum': ['ttm', 'quarterly', 'annual'], 'type': 'string'}}, 'additionalProperties': False}

gex_levels

Gamma exposure (GEX) levels

Dealer 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; Pro: any ticker.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}, 'session': {'type': 'string', 'description': "Trading date YYYY-MM-DD, or 'latest' (default)"}, 'dte_filter': {'type': 'integer', 'description': 'Optional expiry window filter'}}, 'additionalProperties': False}

greek_exposure

Dealer greek exposure

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}, 'session': {'type': 'string', 'description': "Trading date YYYY-MM-DD, or 'latest' (default)"}, 'dte_filter': {'enum': ['all', '0dte', '0+1', 'weekly', 'monthly'], 'type': 'string'}}, 'additionalProperties': False}

insider_trades

Insider trades

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Transactions to return (default 25)'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

intent_flow_current

Options flow intent rankings

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {}, 'additionalProperties': False}

market_tide

Market options tide

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {'top_n': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Top tickers to include (default 25)'}, 'session': {'type': 'string', 'description': "Trading date YYYY-MM-DD, or 'latest' (default)"}}, 'additionalProperties': False}

momentum_rankings

Options flow momentum rankings

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {'top': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Tickers to return (default 50)'}}, 'additionalProperties': False}

oi_movers

Open interest movers

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {'dte': {'enum': ['all', 'lt8', 'gte8'], 'type': 'string'}, 'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Tickers to return (default 50)'}}, 'additionalProperties': False}

oi_timeseries

Open interest history

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

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'dte': {'enum': ['all', 'lt8', 'gte8'], 'type': 'string'}, 'slot': {'enum': ['AM', 'PM'], 'type': 'string'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

register_free_key

Get 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).

外部アクセスあり

入力スキーマ

{'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string', 'description': 'Email address of the person you act for'}, 'agent_name': {'type': 'string', 'maxLength': 60, 'description': "Your assistant's name, shown to them in the email"}}, 'additionalProperties': False}

screener

Multi-signal stock screener

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Rows to return (default 25)'}, 'order': {'enum': ['desc', 'asc'], 'type': 'string'}, 'phase': {'enum': ['any', 'PHASE2', 'PHASE3'], 'type': 'string'}, 'session': {'type': 'string', 'description': "Trading date YYYY-MM-DD, or 'latest' (default)"}, 'signals': {'type': 'array', 'items': {'enum': ['flow', 'oi', 'fda', 'congress'], 'type': 'string'}, 'description': 'Signals a row must carry'}, 'sort_by': {'enum': ['abs_premium', 'net_premium', 'oi_change', 'order_count', 'congress_30d', 'next_fda_days'], 'type': 'string'}, 'direction': {'enum': ['any', 'bullish', 'bearish'], 'type': 'string'}, 'has_congress': {'type': 'boolean', 'description': 'Require congressional trades in the last 30 days'}, 'min_oi_change': {'type': 'integer', 'description': 'Minimum day-over-day OI change'}, 'fda_within_days': {'type': 'integer', 'maximum': 1095, 'minimum': 0, 'description': 'Require an FDA catalyst within N days (0 = no requirement)'}, 'min_abs_premium': {'type': 'number', 'minimum': 0, 'description': 'Minimum absolute net premium in dollars'}}, 'additionalProperties': False}

seasonality

Monthly seasonality

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'years': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Look-back in years (default 10)'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

sector_tide

Sector options tide

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

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {'session': {'type': 'string', 'description': "Trading date YYYY-MM-DD, or 'latest' (default)"}}, 'additionalProperties': False}

short_interest

Short interest

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

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Settlements to return (default 24)'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

short_volume

Daily short volume

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

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Days to return (default 30)'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

stock_candles

Stock intraday candles

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Most recent bars to return (default 120)'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}, 'session': {'type': 'string', 'description': 'YYYY-MM-DD (default today)'}, 'timespan': {'type': 'integer', 'maximum': 60, 'minimum': 1, 'description': 'Minutes per bar (default 1)'}}, 'additionalProperties': False}

stock_news

Stock news with sentiment

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Articles to return (default 10)'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

stock_quote

Stock quote

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

stock_splits

Stock split history

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

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Splits to return (default 20)'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

technical_indicator

Technical indicator

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker', 'indicator'], 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Points to return (default 50)'}, 'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}, 'window': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Look-back window for sma/ema/rsi (default 14)'}, 'timespan': {'enum': ['minute', 'hour', 'day', 'week', 'month', 'quarter', 'year'], 'type': 'string'}, 'indicator': {'enum': ['sma', 'ema', 'rsi', 'macd'], 'type': 'string'}, 'long_window': {'type': 'integer', 'maximum': 500, 'minimum': 1}, 'short_window': {'type': 'integer', 'maximum': 500, 'minimum': 1}, 'signal_window': {'type': 'integer', 'maximum': 500, 'minimum': 1}}, 'additionalProperties': False}

use_api_key

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

冪等

入力スキーマ

{'type': 'object', 'required': ['api_key'], 'properties': {'api_key': {'type': 'string', 'description': 'An ow_free_... or ow_pro_... key'}}, 'additionalProperties': False}

volatility_movers

Implied volatility movers

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Tickers to return (default 10)'}, 'direction': {'enum': ['both', 'expansions', 'compressions'], 'type': 'string'}}, 'additionalProperties': False}

volatility_term_structure

Implied volatility term structure

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.

読み取り専用外部アクセスあり冪等

入力スキーマ

{'type': 'object', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'Stock or ETF ticker, e.g. NVDA, SPY, BRK.B'}}, 'additionalProperties': False}

追加

                            use_api_key
                        

2026年10月4日2:40

追加

                            confirm_registration
                        

2026年10月4日2:40

追加

                            register_free_key
                        

2026年10月4日2:40

追加

                            screener
                        

2026年10月4日2:40

追加

                            seasonality
                        

2026年10月4日2:40

追加

                            insider_trades
                        

2026年10月4日2:40

追加

                            short_volume
                        

2026年10月4日2:40

追加

                            short_interest
                        

2026年10月4日2:40

追加

                            stock_news
                        

2026年10月4日2:40

追加

                            stock_splits
                        

2026年10月4日2:40

追加

                            dividends
                        

2026年10月4日2:40

追加

                            financials
                        

2026年10月4日2:40

追加

                            technical_indicator
                        

2026年10月4日2:40

追加

                            stock_candles
                        

2026年10月4日2:40

追加

                            stock_quote
                        

2026年10月4日2:40

追加

                            contract_historic
                        

2026年10月4日2:40

追加

                            contract_atm
                        

2026年10月4日2:40

追加

                            contract_chain
                        

2026年10月4日2:40

追加

                            oi_timeseries
                        

2026年10月4日2:40

追加

                            oi_movers
                        

2026年10月4日2:40

追加

                            volatility_movers
                        

2026年10月4日2:40

追加

                            volatility_term_structure
                        

2026年10月4日2:40

追加

                            greek_exposure
                        

2026年10月4日2:40

追加

                            gex_levels
                        

2026年10月4日2:40

追加

                            earnings_calendar
                        

2026年10月4日2:40

追加

                            economic_calendar
                        

2026年10月4日2:40

追加

                            earnings_current
                        

2026年10月4日2:40

追加

                            darkpool_ranking
                        

2026年10月4日2:40

追加

                            sector_tide
                        

2026年10月4日2:40

追加

                            market_tide
                        

2026年10月4日2:40

サーバー情報

バージョン

1.4.0

通信方式

Streamable HTTP

ツール

レイテンシ

1546 ms

最終スキャン

2026年10月4日2:40

初回確認

2026年10月4日2:19

エンドポイント

https://api.optionwhales.io/mcp

OptionWhales

このMCPでできること

ツール

最近のツール変更

類似のMCPサーバー

AlpineDataWorks Intelligence Server

Stratalize Finance

Valuein — SEC EDGAR Fundamentals & Smart-Money Data

DFX Real Estate Intelligence

equibles

EventTrader MCP

simplefunctions

Signal8