# 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