Build anything you can think of with our API. Free for 7 days.
Every US options trade, option quotes on every contract, GEX and CME futures. Stream them over WebSocket, or let your AI agent pull them over MCP.
Options Starter and API Basic are free for 7 days on monthly billing. Annual billing saves up to $720 a year.
What's inside
# flow alerts, one call
GET /option-trades/flow-alerts
{
"ticker": "NVDA",
"premium": 2400000,
"side": "call",
"expiry": "2026-08-21",
"unusual": true
}One REST call to the flow
# live socket, zero polling
wss://api.unusualwhales.com/socket
> subscribed: option_trades
{"tk":"NVDA","prem":2400000,"side":"call"}
{"tk":"SPY","prem":1100000,"side":"put"}
{"tk":"AMD","prem":1700000,"side":"call"}
> 3 events · 41msStream it live over WebSockets
# your agent, our data > "build me a scanner for unusual NVDA call sweeps over $1M" mcp: uw.search_option_contracts(...) mcp: uw.get_flow_alerts(...) ✓ scanner running, 3 hits today
Vibecode with MCP
What traders say
Questions, answered
What's the difference between Dashboard & Tools and the API?
Different tools for different jobs. Dashboard & Tools is the website and mobile app: live flow, screeners, alerts, and charts, ready to use. The API is raw programmatic data (REST, WebSocket, MCP) for building your own tools.
Does an API plan include the website?
No. API plans are data-only: they don't include the website or mobile app. If you want the dashboard, that's a Dashboard & Tools plan.
I want the website AND the API. What should I buy?
The Whale Bundle. It includes Dashboard & Tools at the Retail Max tier, full API access, Unusual Predictions, and Data Shop credits (for annual), about 30% less than buying the pieces separately.
I bought the wrong plan. Am I stuck?
No. Switch plans in one click from your account and billing prorates automatically. If you meant to get the API and bought Dashboard & Tools (or the other way around), contact support and they'll move you over.
Is the data real-time?
All API plans include real-time data. All paid dashboard + tools plans include real-time data. Free accounts see delayed data: options flow is 2 trading days behind, news 15 minutes, and alerts 30 minutes.
What's the best way to try Unusual Whales?
Create a free account: the free tier lets you explore the platform with limited data, and the Discord community is always free. Monthly Retail Basic and the API have a free one-week trial. Upgrade in one click when you're ready.
Can I cancel anytime?
Yes. Cancel in two clicks from your account page, no email required, and you keep access through the end of your paid period.
How does annual billing work?
You pay once for 12 months at the discounted rate. Upgrades prorate instantly; downgrades take effect at your next renewal. Subscriptions auto-renew, and you can turn that off anytime.
Can I use my subscription for my business or my customers?
Retail and API plans are for individual use. If you're building a product on our data or need commercial licensing, see the business plans (Startup, Kafka, Enterprise).
Do you offer refunds?
All sales are final. Subscriptions renew automatically and you can cancel future renewals anytime. Picked the wrong product? Contact support within 7 days and we can swap you to another product on the same billing period.
Subscriptions auto-renew; opt out anytime. Not financial advice.
