MCP Server — Connect AI to Market Data
Connect your favorite AI assistant to 50+ financial data tools in under 30 seconds. Analyze options flow, dark pool trades, congressional activity, and more with natural language.
Quickstart guides for your LLM to get you up and running in no time! Doc pages finetuned for AI coding agent understanding.
Quick Setup — Your Favorite AI Assistant
{
"mcpServers": {
"unusual-whales": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.unusualwhales.com/api/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}What you can do
- ✓"Show me unusual options flow on NVDA today"
- ✓"What are Congress members buying this week?"
- ✓"Analyze dark pool activity for SPY"
- ✓"GEX exposure breakdown for TSLA by strike"
- ✓"Find stocks with high IV rank and bullish flow"
Flexible Data Access Methods
REST API
Simple CRUD operations for real-time and historical data access
- ✓JSON responses
- ✓Rate limiting
- ✓Authentication
- ✓Comprehensive documentation
MCP Server
Connect AI assistants to 50+ financial data tools via the Model Context Protocol
- ✓Works with your favorite AI assistant
- ✓50+ tools for options, flow, dark pool, congress
- ✓Natural language queries
- ✓npm package or remote server
WebSockets
Real-time streaming data for live market updates
- ✓Low latency
- ✓Bidirectional
- ✓Auto-reconnection
- ✓Message queuing
Kafka (Enterprise)
High-throughput event streaming for enterprise-scale data processing
- ✓Subscribe to option trades, insider trades, equities & more
- ✓Scalable
- ✓Fault-tolerant
- ✓Partitioning
- ✓Consumer groups
Delayed Data Option: Reduce costs with our 15-minute delayed data option available at reduced pricing on all endpoints. Contact sales for enterprise pricing
Historical Data Downloads
Prefer to work with bulk historical data? Our Data Shop offers downloadable datasets perfect for backtesting strategies, building trading models, and conducting in-depth market research. Access years of historical options flow, price data, insider trades, and more.
Powerful features to inform your trades
Market Tide
Market Tide is a proprietary tool that can be viewed from the Market Tide page.
Contract Screener
A contract screener endpoint to screen the market for contracts by a variety of filter options.
Stock Screener
A stock screener endpoint to screen the market for stocks by a variety of filter options.
Net Premium
Returns the net premium ticks for a given ticker
Dark Pool Levels
Returns the lit & off lit stock volume per price level for the given ticker.
Option Volume Levels
Returns the call and put volume per price level for the given ticker.
Historic Option Volume
Returns the options volume & premium for all trade executions that happened on a given trading date for the given ticker.
Volatility
The average of the latest volatilities for the at the money call and put contracts for every expiry date.
Gamma, Charm, Vanna, Delta
The daily sum of the option greeks based on open contracts. Popular greek exposure values include gamma (GEX) and delta (DEX).
Elevate Your Platform
Empower your platform like Public.com and Perplexity AI with the Unusual Whales API
What our users say
How the API is being used
The UW API has quickly been something I can't trade without. I use various end points such as GEX, volatility skew/term structure, options volume/premium and many other data points. The data has helped me build historical backtests, forecasting models, and other types of stats/ML based research and models.I use these to build out my own screeners for short term trades as well as looking for hedging opportunities on my longer term portfolio. The dev team has been a great resource to work with as well. They are super responsive to issues and are open to feedback on future features that will aid in making my system as profitable as possible.
Out of the 60+ high quality API endpoints that UW offers, my favourite and heavily used one, is the Spot GEX exposures by strike.This invaluable endpoint allows us to monitor the gamma and options volume confluence per strike for a list of tickers within each trading day.Similarly to the Net Flow, we can then chart the top 5 strikes with the most GEXposure and monitor intraday changes and especially OTM strikes showing up and dragging the price higher or lower.The most important aspect of this endpoint is that the volume GEXposure is directionalized, in a similar way as the Net Flow.Thus, whenever a higher strike shows up in the chart, it provides a good opportunity for an intraday trade, provided that we check for further confluence from the various chart in the UW's website.
The UW API allows me to quickly identify and analyze symbols that have shown historically to overprice volatility.Together with correlation statistics this puts me in the position to run a diversified short volatility portfolio with an efficient use of my time.-----------------I found Spot GEX exposures by strike to be the tool that speaks to me about what the underlying developments are, since I am only trading 0DTE. I map, what I refer to as GEX pivots, and see how they develop throughout the trading session.
Plans & Pricing
Try the API for a week
- Real-Time Options Flow (100% Market Coverage)Enriched with bid, ask, greeks, oi, and volume.
- Real-Time Nasdaq Equities Data
- Congressional and Insider Trades
- Darkpool
- Net Premium, Market Tide, Spot GEX, Earnings etc.
- Daily Open Interest including FLEX OI transfer
- 90 Day Historical Lookback
- 30,000 requests per day
- MCP Support
- Custom Skills for your agents
- 1-minute SPX Market Maker Exposure
- Websocket streaming of option trades, SPX Periscope and more.
- Premium endpoints: forex, commodities, economic indicators, digital currencies, top movers, IPO calendar, statistics, extended fundamentals
For individual developers
- Real-Time Options Flow (100% Market Coverage)Enriched with bid, ask, greeks, oi, and volume.
- Real-Time Nasdaq Equities Data
- Congressional and Insider Trades
- Darkpool
- Net Premium, Market Tide, Spot GEX, Earnings etc.
- Daily Open Interest including FLEX OI transfer
- 2 Year Historical Lookback
- 40,000 requests per day
- MCP Support
- Custom Skills for your agents
- 1-minute SPX Market Maker Exposure
- Websocket streaming of option trades, SPX Periscope and more.
- Premium endpoints: forex, commodities, economic indicators, digital currencies, top movers, IPO calendar, statistics, extended fundamentals
- CME futures data (tape, candles, settlement & open interest)
For power users
- Real-Time Options Flow (100% Market Coverage)Enriched with bid, ask, greeks, oi, and volume.
- Real-Time Nasdaq Equities Data
- Congressional and Insider Trades
- Darkpool
- Net Premium, Market Tide, Spot GEX, Earnings etc.
- Daily Open Interest including FLEX OI transfer
- 2 Year Historical Lookback
- Unlimited requests per day
- MCP Support
- Custom Skills for your agents
- 1-minute SPX Market Maker Exposure
- Websocket streaming of option trades, SPX Periscope and more.
- Premium endpoints: forex, commodities, economic indicators, digital currencies, top movers, IPO calendar, statistics, extended fundamentals
- CME futures: live tape streamed over WebSocket, plus candles, settlement & open interestNEW
Terms of Use
The Unusual Whales API is strictly for personal use. Redistribution is not allowed. Users who are found to have redistributed any material will have their accounts terminated with no reimbursement.