Real-time options API

Options flow, dark pool prints, congressional trades, and Greeks. Free 7-day trial.

Options FlowDark PoolCongressionalGreeksVolatilityInstitutionalEarningsGEXNet Flow Exp.Futures

Join thousands of builders and query directly or 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.

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.

A REST API with 100+ endpoints across 19 categories, from near-real-time gamma exposure to the full options tape to the CME futures tape. Optional WebSocket and Kafka streaming when you need real-time.

Endpoints
Categories
Plus WebSocket & Kafka
Example use case

Screen the entire options market for out-of-the-money calls being bought in size, with the exact filters you choose, and get back enriched contracts ready to use. The same filters you use on our website work directly on the API.

GET/api/screener/option-contracts
?type=Calls&is_otm=true&min_premium=250000&min_volume=500
&vol_greater_oi=true&max_dte=183&min_ask_perc=0.7

# response
{
  "data": [
    {
      "ask_side_volume": 119403,
      "avg_price": "1.0466",
      "bid_side_volume": 122789,
      "chain_prev_close": "1.29",
      "close": "0.03",
      "cross_volume": 0,
      "er_time": "unknown",
      "floor_volume": 142,
      "high": "2.95",
      "last_fill": "2023-09-08T17:45:32Z",
      "low": "0.02",
      "mid_volume": 22707,
      "multileg_volume": 7486,
      "next_earnings_date": "2023-10-18",
      "no_side_volume": 0,
      "open": "0.92",
      "open_interest": 18680,
      "option_symbol": "TSLA230908C00255000",
      "premium": "27723806.00",
      "sector": "Consumer Cyclical",
      "stock_multi_leg_volume": 52,
      "stock_price": "247.94",
      "sweep_volume": 18260,
      "ticker_vol": 2546773,
      "total_ask_changes": 44343,
      "total_bid_changes": 43939,
      "trades": 39690,
      "volume": 264899
    }
  ]
}

New: the Earnings Volatility skill scans upcoming earnings for IV-crush setups on top of the same API.

Plus dark pool prints, congressional and insider trades, financials, news, technical indicators, and the CME futures tape, all from the same API key.

Add your API credentials and let your agent do the rest.

"Hey Claude, pull the Unusual Whales skill fromwww.unusualwhales.com/skill.md and set it up"

Tell your agent to pull our skill.md file and it will automatically configure itself with all the Unusual Whales API capabilities.

Features the exact calls you need

Routed to automatically with the MCP server

Cover every aspect of market data

Remotely with no install or locally via npx

Easy starting points for common workflows

infoohlcoption_chainsoption_contractsgreek_exposureiv_rankmax_painoi_changeflow_per_strikeflow_per_expirynet_premium_ticksflowflow_alertsfundamental_breakdowntickerportfoliopeopleeconomic_calendarfda_calendarinsider_buy_sellslatest_filingsinsiders

Featurest the exact calls you need, or take your agent even further with custom queries.

Mr. Whale
Show me the latest unusual option trades for TSLA.

Unusual option trades for TSLA

Time UTCContractPrem
11:234/16CALL
13:454/17PUT

Why they are unusual

  • Sweeps across exchanges: The trades were executed as "sweeps," meaning the buyer aggressively hit multiple exchanges at once to get filled quickly. That often signals urgency and strong conviction.
  • Out-of-the-money calls: Buying far OTM calls (like $450 strikes when TSLA is much lower) suggests traders are betting on a sharp upside move, volatility spike, or gamma squeeze.
  • Short expiration windows: Large bets in weekly expirations are riskier and therefore more unusual than long-dated hedging activity.

Trial

Free/week
  • Options order flow, stocks, congressional & insider trades, market data and proprietary tools
  • 120 requests per minute
  • 30,000 requests per day
  • 90 Day historical look back
  • Singular endpoints provided to access all data
  • Unique endpoints available via API
  • Email & Discord chat support and troubleshooting
  • Available for personal use
  • Live data via websockets

Basic

$100/month
$150
$1,200 billed annually
Save $600 a year
  • Options order flow, stocks, congressional & insider trades, market data and proprietary tools
  • 120 requests per minute
  • 40,000 requests per day
  • 2 Year historical look back
  • Singular endpoints provided to access all data
  • Unique endpoints available via API
  • Email & Discord chat support and troubleshooting
  • Available for personal use
  • Live data via websockets

Advanced

$252/month
$375
$3,024 billed annually
Save $1,476 a year
  • Options order flow, stocks, congressional & insider trades, market data and proprietary tools
  • 120 requests per minute
  • Unlimited requests per day (REST)
  • 2 Year historical look back
  • Singular endpoints provided to access all data
  • Unique endpoints available via API
  • Email & Discord chat support and troubleshooting
  • Available for personal use
  • Live data via websockets

Browse the Unusual Whales data shop to download the exact data file you need:

  • Historical OHLC
  • Options flow
  • OI changes
  • Gamma exposure
  • Dark Pool Feed Data
  • and more...