Machine Readiness
Stored receipt and evidence
30
100
0
0
0
Samples
No stored offer samples.
Samples
No stored action samples.
Samples
No stored product samples.
Document
# *
User-agent: *
Allow: /
# Host
Host: https://unusualwhales.com
# Sitemaps
Sitemap: https://unusualwhales.com/sitemap.xml
Sitemap: https://unusualwhales.com/sitemap-index.xml
Sitemap: https://unusualwhales.com/sitemap/server/sitemap.xml
Sitemap: https://unusualwhales.com/sitemap-news.xml
Disallow: /flow/hot_chains
Disallow: /flow/stock_feed
Disallow: /flow/sectors_watchlist
Disallow: /your-hunt
Disallow: /user_alerts
Disallow: /spacs
Disallow: /test
Disallow: /testing
Disallow: /admin
Document
# Unusual Whales > Unusual Whales is the leading financial market intelligence platform for retail traders. Track real-time options flow, dark pool activity, congressional trades, and unusual stock market data to spot institutional moves and make informed trading decisions. ## About - [About Unusual Whales](https://unusualwhales.com/about): Our mission, story, and impact on financial transparency - [Features Overview](https://unusualwhales.com/features): Complete overview of platform capabilities - [Pricing & Plans](https://unusualwhales.com/pricing): Subscription tiers including free, premium, and enterprise - [FAQ](https://unusualwhales.com/faq): Frequently asked questions ## Options Flow & Analysis - [Live Options Flow](https://unusualwhales.com/live-options-flow): Real-time options activity feed with filtering - [Options Screener](https://unusualwhales.com/options-screener): Filter and find unusual option contracts - [Options Profit Calculator](https://unusualwhales.com/options-profit-calculator): Calculate profit/loss scenarios for options trades - [Option Strategies](https://unusualwhales.com/option-strategies): Educational options strategies with difficulty levels - [Option Flow Alerts](https://unusualwhales.com/option-flow-alerts): Custom alerts for unusual options activity - [Zero DTE Options](https://unusualwhales.com/zero-dte): Same-day expiration options tracking - [Flex Options](https://unusualwhales.com/flex-options): Flex options trading data ## Stock Market Data - [Stock Screener](https://unusualwhales.com/stock-screener): Filter stocks by options activity, volume, and technicals - [Heatmaps](https://unusualwhales.com/heatmaps): Visual market heatmaps - [Correlations](https://unusualwhales.com/correlation): Asset and sector correlation analysis - [Seasonality](https://unusualwhales.com/seasonality): Historical seasonality patterns - [Ticker Performance](https://unusualwhales.com/ticker-performance): Stock performance tracking and comparison ## Dark Pool & Market Flow - [Dark Pool Flow](https://unusualwhales.com/dark-pool-flow): Dark pool activity tracking and analysis - [Flow Overview](https://unusualwhales.com/flow/overview): Overall market options flow overview - [Sector Flow](https://unusualwhales.com/flow/sectors): Sector-level flow analysis - [Lit Flow](https://unusualwhales.com/lit-flow): Lit market options flow data ## Political & Insider Trading - [Congressional Trading](https://unusualwhales.com/politics): Track trades made by U.S. Congress members - [Congress Trading Report 2025](https://unusualwhales.com/congress-trading-report-2025): Annual report on congressional trading - [Insider Trading](https://unusualwhales.com/insiders): Corporate insider trade tracking - [Trump Tracker](https://unusualwhales.com/trump-tracker): Presidential trading activity tracking ## Market Events & Calendars - [Earnings Calendar](https://unusualwhales.com/earnings): Upcoming and recent earnings reports - [Economic Calendar](https://unusualwhales.com/economic-calendar): Economic events and data releases - [FDA Calendar](https://unusualwhales.com/fda-calendar): FDA approval dates and decisions - [Dividends](https://unusualwhales.com/dividends): Dividend announcements and ex-dates - [Stock Splits](https://unusualwhales.com/stock-splits): Stock split announcements - [Trading Halts](https://unusualwhales.com/trading-halts): Active trading halts - [Market Holidays](https://unusualwhales.com/market-holidays): Market holiday schedule ## Portfolio & Trading Tools - [Portfolios](https://unusualwhales.com/portfolios): Community and curated portfolios - [Portfolio Manager](https://unusualwhales.com/portfolio-manager): Portfolio management and trading journal - [Backtesting](https://unusualwhales.com/backtesting/new): Backtest trading strategies - [Paper Trading](https://unusualwhales.com/trade): Practice trading without real money ## Institutional & ETF Data - [Institutions](https://unusualwhales.com/institutions): Institutional investor holdings and 13F filings - [ETFs](https://unusualwhales.com/etfs): ETF data, holdings, and comparison tools - [Analysts](https://unusualwhales.com/analysts): Analyst ratings and price targets ## News & Community - [News](https://unusualwhales.com/news): Financial news feed - [Stock Talk](https://unusualwhales.com/stock-talk): Community discussion forum for stock analysis - [Changelog](https://unusualwhales.com/changelog): Platform updates and new features ## Education - [Trading Course](https://unusualwhales.com/course): Video courses and lectures on trading - [Information & Glossary](https://unusualwhales.com/information): Financial terms and educational content ## Developer & API - [Public API](https://unusualwhales.com/public-api): REST API for market data access with 100+ endpoints across 17 categories - [API Documentation](https://api.unusualwhales.com/docs#/): Interactive API reference with endpoint details and schemas - [API Examples](https://unusualwhales.com/public-api/examples): Code examples and integration tutorials - [MCP Server](https://unusualwhales.com/public-api/mcp): Model Context Protocol integration with 17 tools, 114+ actions, and 30 built-in prompts - [Kafka Streaming](https://unusualwhales.com/public-api/kafka): Enterprise Kafka streaming with 20+ topics, <10ms latency, and 72h retention - [Developer Resources](https://unusualwhales.com/developers): SDKs, integration guides, and developer hub - [API Terms of Service](https://unusualwhales.com/api-terms-of-service): API usage terms ### API Endpoint Categories - **Stock Data**: OHLC, fundamentals, ownership (premium), analyst ratings, price targets, earnings history, market cap history, correlations - **Options Flow**: Real-time flow alerts, full tape, net flow by expiry, Greek-weighted flow, unusual tickers, lit flow - **Options Contracts**: Contract flow, historical data, intraday data, volume profiles - **Greeks & Volatility**: Greek exposure (gamma, delta, vanna, charm), IV rank, IV term structure, risk reversal, volatility skew, interpolated IV - **Dark Pool**: Recent dark pool transactions, per-ticker dark pool data, off-lit price levels - **Market Data**: Market tide, sector tide, ETF tide, economic calendar, FDA calendar, total options volume, top net impact - **Congressional Trading**: Recent trades, late reports, individual congress trader data - **Politician Data** (Premium): People lookup, portfolios, trade history, stock holders, financial disclosures — email support@unusualwhales.com to get access - **Insider Trading**: Transactions, sector flow, ticker flow, insider profiles - **Institutional Holdings**: Institution list, holdings, activity, sector breakdown, ownership, latest 13F filings - **Earnings**: Premarket reports, after-hours reports, per-ticker earnings - **ETF Data**: Info, holdings, sector exposure, inflows/outflows, weights - **Short Selling**: Short data, fails-to-deliver, short interest/float ratio, volume by exchange, short screener - **Seasonality**: Market-wide seasonality, top performers, monthly and yearly patterns - **Screeners**: Stock screener, option contract screener - **News**: Headlines feed - **Cryptocurrency**: State, OHLC, whale transactions ### Data Freshness & Update Frequencies - **Real-time**: Options flow, stock quotes, dark pool trades, trading halts (via REST, WebSocket, and Kafka) - **Sub-10ms latency**: Kafka streaming for enterprise consumers - **Intraday**: Greek exposure, IV data, net premium, flow summaries update continuously during market hours - **Daily**: OHLC data, short interest, institutional holdings updates, stock directory - **Event-driven**: Earnings, FDA calendar, economic events, insider trades, congressional disclosures (updated as filings are published) - **15-minute delayed**: Available at reduced pricing for cost-sensitive use cases ### Sample Use Cases - **Algorithmic Trading**: Stream real-time options flow and dark pool data via Kafka or WebSocket to build automated trading signals - **Quantitative Research**: Backtest strategies using historical options flow, Greek exposure, and volatility data via the REST API - **Portfolio Management**: Track institutional holdings changes, insider activity, and analyst rating shifts to inform allocation decisions - **Market Surveillance**: Monitor unusual options activity, dark pool volume spikes, and congressional trading patterns for anomaly detection - **AI-Powered Analysis**: Connect LLMs and AI agents to live market data via MCP for natural language research and analysis - **Risk Management**: Monitor Greek exposure, IV rank changes, and short interest to assess portfolio risk in real time - **Financial Media & Content**: Pull market data, earnings calendars, and flow summaries to power dashboards, newsletters, and reports ### MCP Server for AI Agents The Unusual Whales MCP server enables AI assistants to query market data through natural language. Available as a remote server (no install) or local npm package (`@unusualwhales/mcp`). **17 Tools with 114+ Actions:** - `uw_stock` (44 actions): Stock info, OHLC, option chains, Greeks, IV, fundamentals, analyst data, earnings, flow summary (note: "ownership" action is premium — email support@unusualwhales.com to get access) - `uw_options` (4 actions): Contract flow, historical data, intraday, volume profiles - `uw_flow` (8 actions): Flow alerts, full tape, net flow, Greek flow, unusual tickers - `uw_market` (12 actions): Market tide, sector tide, ETF tide, economic/FDA calendar, correlations - `uw_darkpool` (2 actions): Recent dark pool data, per-ticker dark pool - `uw_congress` (3 actions): Recent congressional trades, late reports, trader profiles - `uw_politicians` (5 actions): People lookup, portfolios, trades, holders, disclosures — **Premium: email support@unusualwhales.com to get access** - `uw_insider` (4 actions): Transactions, sector flow, ticker flow, insider profiles - `uw_institutions` (6 actions): List, holdings, activity, sectors, ownership, filings - `uw_earnings` (3 actions): Premarket, after-hours, per-ticker - `uw_etf` (5 actions): Info, holdings, exposure, inflows/outflows, weights - `uw_shorts` (7 actions): Short data, FTDs, interest/float, volume ratios, screener - `uw_seasonality` (4 actions): Market, performers, monthly, yearly - `uw_screener` (2 actions): Stock screener, option contract screener - `uw_news` (1 action): Headlines - `uw_alerts` (2 actions): Alerts, configurations - `uw_crypto` (4 actions): State, OHLC, whale transactions **30 Built-in Prompts** for common workflows: daily summaries, ticker analysis, pre-earnings analysis, unusual flow scanning, dark pool scanning, sector flow, Greek exposure, IV screening, earnings calendar, congress tracking, bullish/bearish confluence screening, and more. **Supported IDEs**: Claude Desktop, Cursor, VS Code, Windsurf ## Apps & Integrations - [Apps](https://unusualwhales.com/apps): Mobile apps and platform downloads - [Discord Bot](https://unusualwhales.com/discord-bot): Options flow bot for Discord - [Community Hub](https://unusualwhales.com/community): Discord and social community links ## Company - [Careers](https://unusualwhales.com/careers): Open positions at Unusual Whales - [Enterprise](https://unusualwhales.com/enterprise/organization): Enterprise solutions for institutions - [Advertise](https://unusualwhales.com/advertise): Advertising opportunities - [Contact](https://unusualwhales.com/contacts): Get in touch - [Privacy Policy](https://unusualwhales.com/privacy): Privacy policy - [Terms of Service](https://unusualwhales.com/terms): Terms of service - [Disclaimer](https://unusualwhales.com/disclaimer): Legal disclaimer
Document
# Unusual Whales > Unusual Whales is the leading financial market intelligence platform for retail traders. Track real-time options flow, dark pool activity, congressional trades, and unusual stock market data to spot institutional moves and make informed trading decisions. Unusual Whales provides retail traders with comprehensive options and equity flow data, market analysis tools, and educational resources. The platform tracks institutional trading activity, congressional stock trades, dark pool flow, and unusual options activity to level the playing field between retail and institutional traders. ## About - [About Unusual Whales](https://unusualwhales.com/about): Learn about our mission to bring financial transparency to retail traders. Unusual Whales was founded to democratize access to market data that was previously only available to institutional investors. - [Features Overview](https://unusualwhales.com/features): Complete overview of all platform tools and capabilities including options flow, dark pool tracking, congressional trading data, stock screeners, and more. - [Pricing & Plans](https://unusualwhales.com/pricing): Compare subscription plans including free tier, premium web access, Discord bot, portfolio tracking, and API access. Find the right plan for your trading needs. - [FAQ](https://unusualwhales.com/faq): Frequently asked questions about the platform, subscriptions, data, and trading tools. ## Options Flow & Analysis Options flow tracking is the core of Unusual Whales. The platform monitors millions of options contracts in real-time to surface unusual activity that may indicate institutional or informed trading. - [Live Options Flow](https://unusualwhales.com/live-options-flow): Real-time feed of options transactions across all U.S. equities. Filter by ticker, expiration, strike, premium, volume, and more. Identify sweeps, blocks, and unusual activity as it happens. - [Options Screener](https://unusualwhales.com/options-screener): Advanced screening tool to filter options contracts by over 20 criteria including open interest, implied volatility, Greeks, volume ratios, and unusual activity scores. - [Options Profit Calculator](https://unusualwhales.com/options-profit-calculator): Interactive tool to calculate potential profit and loss for single-leg and multi-leg options strategies. Visualize payoff diagrams and break-even points. - [Option Strategies](https://unusualwhales.com/option-strategies): Educational resource covering options strategies from beginner to advanced levels, including covered calls, spreads, straddles, iron condors, and more. - [Option Flow Alerts](https://unusualwhales.com/option-flow-alerts): Set up custom alerts for unusual options activity based on your criteria. Get notified via web, Discord, or email when significant flow is detected. - [Zero DTE Options](https://unusualwhales.com/zero-dte): Track same-day expiration (0 DTE) options activity, which has become an increasingly significant part of options market volume. - [Flex Options](https://unusualwhales.com/flex-options): Monitor flex options contracts — customized options with non-standard terms negotiated between parties. - [Non-Standard Options](https://unusualwhales.com/non-standard-options): Track non-standard options contracts resulting from corporate actions like mergers, spinoffs, and special dividends. ### Per-Ticker Options Data Each stock ticker page at `/stock/[symbol]/` provides detailed options data including: - [Option Chains](https://unusualwhales.com/stock/AAPL/option-chains): Full option chain with real-time pricing, Greeks, and volume for any ticker. - [Greek Exposure](https://unusualwhales.com/stock/AAPL/greek-exposure): Aggregate delta, gamma, and vanna exposure across all strikes and expirations. - [Net Premium](https://unusualwhales.com/stock/AAPL/net-premium): Track cumulative net premium (calls vs puts) to gauge directional sentiment. - [Flow Overview](https://unusualwhales.com/stock/AAPL/flow-overview): Options flow summary for a specific ticker with volume, premium, and put/call ratios. - [Flow Levels](https://unusualwhales.com/stock/AAPL/flow-levels): Identify key strike levels where options flow is concentrated. - [Volatility](https://unusualwhales.com/stock/AAPL/volatility): Implied volatility rank, IV percentile, and historical volatility analysis. ## Stock Market Data - [Stock Screener](https://unusualwhales.com/stock-screener): Screen stocks using fundamental, technical, and options-based criteria. Filter by market cap, sector, volume, options flow, short interest, and more. - [Heatmaps](https://unusualwhales.com/heatmaps): Visual treemap heatmaps showing market performance by sector, market cap, and custom groupings. Quickly identify which areas of the market are moving. - [Correlations](https://unusualwhales.com/correlation): Analyze statistical correlations between stocks, ETFs, and sectors. Identify diversification opportunities and correlated risk. - [Seasonality](https://unusualwhales.com/seasonality): Historical seasonality patterns showing average returns by month, day of week, and around events for any ticker. - [Ticker Performance](https://unusualwhales.com/ticker-performance): Compare performance of multiple tickers over custom time periods. - [Futures](https://unusualwhales.com/futures): Real-time futures data for major indices, commodities, and currencies. ### Per-Ticker Stock Data Each stock ticker page at `/stock/[symbol]/` provides: - [Overview](https://unusualwhales.com/stock/AAPL/overview): Complete stock dashboard with price, fundamentals, technicals, and key metrics. - [Chart](https://unusualwhales.com/stock/AAPL/chart): Interactive charting with technical indicators, drawing tools, and options flow overlay. - [Earnings](https://unusualwhales.com/stock/AAPL/earnings): Historical and upcoming earnings data, EPS estimates, and revenue. - [Dividends](https://unusualwhales.com/stock/AAPL/dividends): Dividend history, yield, and upcoming ex-dates. - [Institutions](https://unusualwhales.com/stock/AAPL/institutions): Institutional holders, 13F filings, and changes in ownership. - [Analysts](https://unusualwhales.com/stock/AAPL/analysts): Analyst ratings, price targets, and consensus estimates. - [Short Interest](https://unusualwhales.com/stock/AAPL/shortshorts): Short interest data, days to cover, and short squeeze potential. - [Seasonality](https://unusualwhales.com/stock/AAPL/seasonality): Ticker-specific historical seasonality patterns. - [Heatmap](https://unusualwhales.com/stock/AAPL/heatmap): Visual option chain heatmap by strike and expiration. ## Dark Pool & Market Flow Dark pools are private exchanges where large institutional orders are executed away from public markets. Unusual Whales tracks this activity to give retail traders visibility into institutional positioning. - [Dark Pool Flow](https://unusualwhales.com/dark-pool-flow): Real-time dark pool transaction data with volume, price, and directional analysis. Track where institutions are accumulating or distributing shares. - [Flow Overview](https://unusualwhales.com/flow/overview): High-level dashboard of overall market options flow, including total premium, put/call ratios, and sector breakdowns. - [Sector Flow](https://unusualwhales.com/flow/sectors): Options flow aggregated by market sector. Identify which sectors are seeing unusual institutional activity. - [Lit Flow](https://unusualwhales.com/lit-flow): Options flow data from lit (public) exchanges, complementing dark pool data for a complete picture. - [Flow Correlations](https://unusualwhales.com/flow/correlations): Analyze how options flow correlates with price movements across tickers and sectors. ## Political & Insider Trading Unusual Whales pioneered tracking congressional stock trades, bringing transparency to potential conflicts of interest in government. - [Congressional Trading](https://unusualwhales.com/politics): Comprehensive database of stock trades made by U.S. Congress members, as disclosed under the STOCK Act. Search by politician, party, ticker, or date. - [Congress Trading Report 2025](https://unusualwhales.com/congress-trading-report-2025): Annual analysis of congressional trading patterns, top performers, and notable trades. - [Congress Trading Report 2024](https://unusualwhales.com/congress-trading-report-2024): Previous year's congressional trading analysis. - [Senate Trading](https://unusualwhales.com/i_am_the_senate): Detailed Senate member trading activity with performance tracking. - [Insider Trading](https://unusualwhales.com/insiders): Track SEC Form 4 filings showing corporate insider (CEO, CFO, directors) buying and selling activity. - [Trump Tracker](https://unusualwhales.com/trump-tracker): Track presidential trading activity and policy impacts on markets. ## Market Events & Calendars - [Earnings Calendar](https://unusualwhales.com/earnings): Comprehensive earnings calendar with EPS estimates, revenue forecasts, and historical data. Filter by date, before/after market hours. - [Premarket Earnings](https://unusualwhales.com/earnings/premarket): Companies reporting earnings before market open. - [After-Hours Earnings](https://unusualwhales.com/earnings/afterhours): Companies reporting earnings after market close. - [Economic Calendar](https://unusualwhales.com/economic-calendar): Schedule of economic data releases (CPI, jobs, GDP, etc.) and their expected impact on markets. - [Fed Speakers](https://unusualwhales.com/economic-calendar/fed-speakers): Federal Reserve official speaking schedule and policy implications. - [FDA Calendar](https://unusualwhales.com/fda-calendar): FDA approval dates, PDUFA dates, and advisory committee meetings for pharmaceutical stocks. - [Dividends](https://unusualwhales.com/dividends): Dividend announcements, ex-dates, and payment dates across the market. - [Stock Splits](https://unusualwhales.com/stock-splits): Upcoming and recent stock split announcements. - [Trading Halts](https://unusualwhales.com/trading-halts): Real-time list of stocks halted for trading by exchanges. - [Market Holidays](https://unusualwhales.com/market-holidays): U.S. stock market holiday schedule and early close dates. ## Portfolio & Trading Tools - [Portfolios](https://unusualwhales.com/portfolios): Browse community-created and curated portfolios. Follow popular portfolios like the Nancy Pelosi portfolio or create your own. - [Portfolio Manager](https://unusualwhales.com/portfolio-manager): Full portfolio management dashboard with P&L tracking, allocation analysis, and trading journal. - [Backtesting](https://unusualwhales.com/backtesting/new): Backtest trading strategies against historical data to evaluate performance before risking real capital. - [Paper Trading](https://unusualwhales.com/trade): Simulated trading platform to practice strategies with virtual money in real market conditions. - [Custom Alerts](https://unusualwhales.com/custom-alerts): Build custom alert rules based on price, volume, options flow, and technical indicators. - [Event Contracts](https://unusualwhales.com/event-contracts): Track and analyze event-based derivatives contracts. ## Institutional & ETF Data - [Institutions](https://unusualwhales.com/institutions): Browse institutional investor 13F filings. See what hedge funds, mutual funds, and asset managers are buying and selling. Track changes in positions over time. - [ETFs](https://unusualwhales.com/etfs): ETF data including holdings, sector exposure, performance, and comparison tools. - [ETF Holdings](https://unusualwhales.com/etf/SPY/holdings): Detailed ETF holdings breakdown with weight, sector, and overlap analysis. - [ETF Comparison](https://unusualwhales.com/etf/SPY/comparison): Compare multiple ETFs side by side on performance, fees, holdings overlap, and more. - [ETF Heatmaps](https://unusualwhales.com/etf/SPY/heatmaps): Visual heatmap of ETF holdings and their performance. - [Analysts](https://unusualwhales.com/analysts): Analyst ratings, price targets, upgrades, and downgrades. Track analyst accuracy and performance. ## News & Community - [News](https://unusualwhales.com/news): Curated financial news feed covering market-moving events, earnings, economic data, and analysis. - [Stock Talk](https://unusualwhales.com/stock-talk): Community forum where traders discuss stocks, share analysis, and debate trading ideas. Posts are organized by ticker for easy discovery. - [Trending Discussions](https://unusualwhales.com/stock-talk/trending): Most active and engaging community discussions. - [Changelog](https://unusualwhales.com/changelog): Platform release notes detailing new features, improvements, and bug fixes. ## Education - [Trading Course](https://unusualwhales.com/course): Structured video courses covering options basics, flow analysis, strategy development, and advanced trading concepts. - [Information & Glossary](https://unusualwhales.com/information): Comprehensive glossary of financial and options trading terms with detailed explanations. ## Developer & API Unusual Whales provides programmatic access to its data through multiple interfaces for developers, quantitative analysts, and firms. The API serves 100+ endpoints across 17 categories with data available via REST, WebSocket, Kafka streaming, and MCP. - [Public API](https://unusualwhales.com/public-api): RESTful API for accessing options flow, stock data, dark pool data, congressional trades, and more. Includes documentation and code examples. - [API Documentation](https://api.unusualwhales.com/docs#/): Interactive API reference with full endpoint details, request/response schemas, and try-it-out functionality. - [API Examples](https://unusualwhales.com/public-api/examples): Code examples and tutorials for integrating the Unusual Whales API into your applications. - [MCP Server](https://unusualwhales.com/public-api/mcp): Model Context Protocol (MCP) server integration with 17 tools, 114+ actions, and 30 built-in analysis prompts. Connect AI assistants and LLMs directly to Unusual Whales market data. - [Kafka Streaming](https://unusualwhales.com/public-api/kafka): Enterprise-grade Apache Kafka streaming for real-time market data delivery with replay capability, <10ms latency, and 72-hour retention. - [Developer Resources](https://unusualwhales.com/developers): Developer hub with documentation, SDKs, and integration guides. - [API Terms of Service](https://unusualwhales.com/api-terms-of-service): Terms governing API usage, rate limits, and data redistribution. ### API Endpoint Categories The API is organized into 17 endpoint categories covering every aspect of market data: **Stock Data** — Ticker info, OHLC prices, option chains, option contracts, Greeks, Greek exposure, Greek flow, IV rank, max pain, open interest changes, flow per strike, flow per expiry, net premium ticks, volume/OI per expiry, options volume, volatility term structure, IV term structure, risk reversal, volatility skew, interpolated IV, historical IV, IV change, IV rank history, insider buy/sells, ownership, fundamental breakdown, sector ETFs, correlations, analyst ratings, analyst actions, price targets, next earnings, earnings history, flow summary, spike detection, short interest, off-lit price levels, volume price levels, option price levels, FDA calendar, economic calendar, and market cap history. **Options Flow** — Real-time flow alerts, full options tape, net flow by expiry, group Greek flow, group Greek flow by expiry, lit flow (recent and per-ticker), and unusual tickers detection. **Options Contracts** — Individual contract flow, historical contract data, intraday contract data, and volume profiles. **Market Data** — Market tide (proprietary sentiment indicator), sector tide, ETF tide, sector ETFs, economic calendar, FDA calendar, cross-asset correlations, insider buy/sell aggregates, open interest changes, spike detection, top net impact tickers, and total options volume. **Dark Pool** — Recent dark pool transactions across all tickers and per-ticker dark pool activity with price level analysis. **Congressional Trading** — Recent trades filed under the STOCK Act, late filing reports, and individual congress member trader profiles. **Politician Data** — People directory, individual politician portfolios, recent trades, stock holders in congress, and financial disclosures. **Insider Trading** — SEC Form 4 transactions, sector-level insider flow, ticker-level insider flow, and insider profiles. **Institutional Holdings** — Institution directory, 13F holdings, activity/changes, sector breakdown, per-ticker ownership, and latest filing dates. **Earnings** — Premarket earnings reports, after-hours earnings reports, and per-ticker earnings data. **ETF Data** — ETF info, holdings breakdown, sector exposure, inflow/outflow tracking, and component weights. **Short Selling** — Short interest data, fails-to-deliver (FTDs), short interest as percentage of float, short volume ratios, volume by exchange, and short screener. **Seasonality** — Market-wide seasonality patterns, top seasonal performers, monthly patterns, and year-over-month comparisons. **Screeners** — Stock screener with 20+ filter criteria and option contract screener for finding specific opportunities. **News** — Financial news headlines feed. **Alerts** — User alert data and alert configuration management. **Cryptocurrency** — Crypto state data, OHLC pricing, recent whale transactions, and individual whale transaction details. ### Data Freshness & Update Frequencies Unusual Whales data is updated at varying frequencies depending on the data type: - **Real-time (sub-second)**: Options flow transactions, stock quotes, dark pool trades, and trading halts are streamed in real-time via REST polling, WebSocket connections, and Kafka topics. - **Sub-10ms latency**: Kafka streaming delivers market data to enterprise consumers with under 10 milliseconds of latency and 99.9% uptime. - **Continuous intraday updates**: Greek exposure (gamma, delta, vanna, charm), implied volatility data, net premium, flow summaries, and market tide indicators update continuously throughout market hours. - **Daily updates**: OHLC price data, short interest figures, institutional holdings changes, stock directory, and end-of-day aggregations. - **Event-driven**: Earnings reports, FDA calendar events, economic data releases, SEC insider filings (Form 4), and congressional STOCK Act disclosures are updated as soon as filings are published. - **72-hour retention**: Kafka streaming retains messages for 72 hours with configurable offsets, allowing consumers to replay missed data after downtime. - **15-minute delayed option**: Available at reduced pricing for applications that don't require real-time data. ### Data Access Methods - **REST API**: Standard HTTP JSON API with authentication via API key. Rate limited at 120 requests/minute (default), with higher limits available for enterprise plans. - **WebSocket**: Real-time bidirectional streaming with auto-reconnection and message queuing. Ideal for live dashboards and trading applications. - **Kafka Streaming**: Enterprise-grade Apache Kafka with SASL/PLAIN over TLS authentication and Protocol Buffers serialization. 20+ topics across options flow, Greeks, market data, chain data, institutional filings, and ETFs. Supports consumer groups for horizontal scaling and exactly-once/at-least-once delivery guarantees. Bootstrap server: `stream.unusualwhales.com:9083`. - **MCP (Model Context Protocol)**: Enables AI assistants and LLMs to query market data through natural language. Available as a remote server endpoint or local npm package. ### Kafka Streaming Topics **Options Flow Topics**: flow-alerts, all-option-trades, flow-expiry, flow-strike, interval-flow, greek-flow **Greeks & Volatility Topics**: option-greeks, iv-term-structure, interpolated-iv, risk-reversal-skew **Market Data Topics**: ticker-quotes, all-trade-reports (lit and off-lit), ticker-stock-states, trading-halts, stock-directory **Chain Data Topics**: option-states (live contract updates with volumes, OI, Greeks), chain-vol-price-lvl, chain-frag (interval flow for scanning high-volume contracts), chain-agg (volume and premium aggregation for building 1-min charts) **Institutional & Filings Topics**: insider-trades, sec-filings **ETF Topics**: etf-tide ### Sample Use Cases **Algorithmic Trading**: Stream real-time options flow alerts and dark pool transactions via Kafka to build automated trading signals. Use Greek exposure data to dynamically hedge positions. Consume the full options tape for custom signal generation. **Quantitative Research**: Access historical options flow, Greek exposure, IV term structure, and volatility skew data via the REST API. Backtest strategies against historical earnings moves, seasonality patterns, and institutional positioning changes. **Portfolio Management**: Track 13F institutional holdings changes to understand smart money positioning. Monitor insider buying/selling patterns for conviction signals. Use analyst rating shifts and price target changes to inform allocation decisions. Build custom alert rules for portfolio positions. **Market Surveillance & Compliance**: Monitor unusual options activity and dark pool volume spikes for anomaly detection. Track congressional trading disclosures for potential conflicts of interest. Screen for insider trading patterns across sectors. **AI-Powered Financial Analysis**: Connect LLMs (Claude, GPT, etc.) to live market data via the MCP server for natural language research. Ask questions like "Show me unusual options flow on NVDA today" or "What are Congress members buying this week?" and get real-time data-backed answers. **Risk Management**: Monitor aggregate Greek exposure (gamma, delta, vanna, charm) across positions. Track IV rank changes and volatility term structure shifts. Use short interest data and fails-to-deliver to assess squeeze risk. Set up custom alerts for risk threshold breaches. **Financial Media & Content**: Pull market data, earnings calendars, flow summaries, and congressional trading reports to power dashboards, newsletters, social media content, and financial news coverage. **Education & Paper Trading**: Use the paper trading platform and backtesting tools alongside API data to learn options strategies and test theories without risking real capital. ### MCP Server for AI Agents The Unusual Whales MCP (Model Context Protocol) server enables AI assistants to query comprehensive market data through natural language. It is the fastest way to connect an LLM to real-time financial data. **Setup**: Available as a remote server (no installation required, connect via URL) or as a local npm package (`@unusualwhales/mcp`) that runs via npx. Requires Node.js 18+ for local mode. **Remote endpoint**: `https://api.unusualwhales.com/api/mcp` **npm package**: `@unusualwhales/mcp` **Supported IDEs & AI Assistants**: Claude Desktop, Claude Code (CLI), Cursor, VS Code, Windsurf. Any MCP-compatible client can connect. **17 Tools with 114+ Actions:** | Tool | Actions | Description | |------|---------|-------------| | `uw_stock` | 44 | Stock info, OHLC, option chains, Greeks, IV, fundamentals, analysts, earnings, flow summary, short interest, price levels | | `uw_options` | 4 | Contract flow, historical data, intraday data, volume profiles | | `uw_flow` | 8 | Flow alerts, full tape, net flow by expiry, Greek flow, unusual tickers, lit flow | | `uw_market` | 12 | Market tide, sector tide, ETF tide, economic/FDA calendar, correlations, total options volume | | `uw_darkpool` | 2 | Recent dark pool transactions, per-ticker dark pool data | | `uw_congress` | 3 | Recent congressional trades, late reports, trader profiles | | `uw_politicians` | 5 | People lookup, portfolios, trades, holders, disclosures | | `uw_insider` | 4 | Insider transactions, sector flow, ticker flow, profiles | | `uw_institutions` | 6 | Institution list, holdings, activity, sectors, ownership, filings | | `uw_earnings` | 3 | Premarket, after-hours, per-ticker | | `uw_etf` | 5 | Info, holdings, exposure, inflows/outflows, weights | | `uw_shorts` | 7 | Short data, FTDs, interest/float, volume ratios, screener | | `uw_seasonality` | 4 | Market, performers, monthly, yearly patterns | | `uw_screener` | 2 | Stock screener, option contract screener | | `uw_news` | 1 | Headlines | | `uw_alerts` | 2 | Alerts, configurations | | `uw_crypto` | 4 | State, OHLC, whale transactions | **30 Built-in Analysis Prompts** organized by category: - **Market Overview**: daily-summary, morning-briefing, end-of-day-recap - **Ticker Analysis**: ticker-analysis, pre-earnings, options-setup, short-interest, seasonality, option-contract - **Flow & Activity**: unusual-flow, dark-pool-scanner, insider-scanner, institutional-activity, analyst-tracker - **Smart Money & Sectors**: sector-flow, etf-flow, greek-exposure, iv-screener, correlation-analysis, top-movers - **Calendars & Events**: earnings-calendar, fda-calendar, economic-calendar, congress-tracker, politician-portfolio - **Screening**: bullish-confluence, bearish-confluence, weekly-expiration, news-scanner **Example natural language queries:** - "Show me unusual options flow on NVDA today" → uses `uw_flow.flow_alerts`, `uw_stock.flow_summary` - "What are Congress members buying this week?" → uses `uw_congress.recent_trades` - "Analyze dark pool activity for SPY" → uses `uw_darkpool.ticker`, `uw_stock.off_lit_price_levels` - "Give me a full market overview with sector sentiment" → uses `uw_market.market_tide`, `uw_market.sector_tide`, `uw_market.total_options_volume` - "Show insider buying in the technology sector" → uses `uw_insider.sector_flow`, `uw_insider.transactions` - "Find stocks with high IV rank and bullish flow" → uses `uw_screener.stocks`, `uw_flow.flow_alerts` **Configuration**: Rate limit defaults to 120 requests/minute. Supports max retries (default 3) and circuit breaker pattern (threshold 5, reset timeout 30s) for resilient operation. ## Apps & Integrations - [Apps](https://unusualwhales.com/apps): Download Unusual Whales on iOS, Android, and desktop platforms. - [Discord Bot](https://unusualwhales.com/discord-bot): Add the Unusual Whales bot to your Discord server for real-time options flow alerts, stock lookups, and market data directly in chat. - [Community Hub](https://unusualwhales.com/community): Join the Unusual Whales community on Discord, Twitter, YouTube, and Instagram. ## Data Coverage Unusual Whales covers: - **Options:** Real-time flow for all U.S. equity options across all exchanges, including standard, flex, non-standard, and zero-DTE contracts - **Equities:** All U.S.-listed stocks (NYSE, NASDAQ, AMEX) with OHLC, fundamentals, technicals, and ownership data - **Dark Pools:** Off-exchange transaction data with price level analysis and volume tracking - **ETFs:** Full ETF universe with holdings, sector exposure, inflow/outflow, and comparison tools - **Futures:** Major index, commodity, and currency futures - **Crypto:** Cryptocurrency pricing, OHLC data, and whale transaction monitoring - **Congressional Trades:** All STOCK Act disclosures from U.S. House and Senate members - **Insider Trades:** All SEC Form 4 filings from corporate officers, directors, and 10% owners - **Institutional Holdings:** 13F filings from hedge funds, mutual funds, and asset managers - **Analyst Data:** Ratings, price targets, upgrades, downgrades, and estimate revisions - **Greeks & Volatility:** Delta, gamma, vanna, charm exposure; IV rank, IV percentile, term structure, skew - **Short Selling:** Short interest, fails-to-deliver, short volume ratios, and exchange-level breakdown - **Seasonality:** Historical return patterns by month, day of week, and around events ## Company - [Careers](https://unusualwhales.com/careers): Open positions at Unusual Whales. We're hiring engineers, data scientists, and more. - [Enterprise](https://unusualwhales.com/enterprise/organization): Enterprise solutions for hedge funds, proprietary trading firms, and financial institutions. Custom data feeds, white-label solutions, and dedicated support. - [Advertise](https://unusualwhales.com/advertise): Advertising and sponsorship opportunities on the Unusual Whales platform. - [Contact](https://unusualwhales.com/contacts): Get in touch with our team for support, partnerships, or press inquiries. - [Privacy Policy](https://unusualwhales.com/privacy): How we collect, use, and protect your data. - [Terms of Service](https://unusualwhales.com/terms): Terms governing use of the Unusual Whales platform. - [Disclaimer](https://unusualwhales.com/disclaimer): Legal disclaimer — Unusual Whales is not a financial advisor and does not provide investment advice. ## Social - Twitter: [@unusual_whales](https://twitter.com/unusual_whales) - YouTube: [Unusual Whales](https://www.youtube.com/c/UnusualWhales) - Instagram: [@unusualwhales](https://www.instagram.com/unusualwhales/)