Access UnusualWhales stock data including options chains, greeks, IV, OHLC candles, open interest, and more.

Available actions:

• info: Get stock information (ticker required)

• ohlc: Get OHLC candles (ticker, candle_size required; date, timeframe, end_date, limit optional)

• option_chains: Get option chains (ticker required; date optional)

• option_contracts: Get option contracts (ticker, expiry required; option_type, filters, limit optional)

• greeks: Get greeks data (ticker, expiry required; date optional)

• greek_exposure: Get gamma/delta/vanna exposure (ticker required; date, timeframe optional)

• greek_exposure_by_expiry: Get greek exposure by expiry (ticker required; date optional)

• greek_exposure_by_strike: Get greek exposure by strike (ticker required; date optional)

• greek_exposure_by_strike_expiry: Get greek exposure by strike and expiry (ticker, expiry required; date optional)

• greek_flow: Get greek flow (ticker required; date optional)

• greek_flow_by_expiry: Get greek flow by expiry (ticker, expiry required; date optional)

• iv_rank: Get IV rank (ticker required; date, timespan optional)

• interpolated_iv: Get interpolated IV (ticker required; date optional)

• max_pain: Get max pain (ticker required; date optional)

• oi_change: Get OI change (ticker required; date, limit, page, order optional)

• oi_per_expiry: Get OI per expiry (ticker required; date optional)

• oi_per_strike: Get OI per strike (ticker required; date optional)

• options_volume: Get options volume (ticker required; limit optional)

• volume_oi_expiry: Get volume/OI by expiry (ticker required; date optional)

• atm_chains: Get ATM chains for given expirations (ticker, expirations required)

• expiry_breakdown: Get expiry breakdown (ticker required; date optional)

• flow_per_expiry: Get flow per expiry (ticker required)

• flow_per_strike: Get flow per strike (ticker required; date optional)

• flow_per_strike_intraday: Get intraday flow per strike (ticker required; date, filter optional)

• flow_recent: Get recent flow (ticker required; side, min_premium optional)

• net_prem_ticks: Get net premium ticks (ticker required; date optional)

• nope: Get NOPE data (ticker required; date optional)

• stock_price_levels: Get stock price levels (ticker required; date optional)

• stock_volume_price_levels: Get volume price levels (ticker required; date optional)

• spot_exposures: Get spot exposures (ticker required; date optional)

• spot_exposures_by_expiry_strike: Get spot exposures by expiry/strike (ticker, expirations required; date, filters optional)

• spot_exposures_by_strike: Get spot exposures by strike (ticker required; date, filters optional)

• spot_exposures_expiry_strike: Get spot exposures for specific expiry (ticker, expirations required; date, strike filters optional)

• historical_risk_reversal_skew: Get risk reversal skew (ticker, expiry, delta required; date, timeframe optional)

• volatility_realized: Get realized volatility (ticker required; date, timeframe optional)

• volatility_stats: Get volatility stats (ticker required; date optional)

• volatility_term_structure: Get term structure (ticker required; date optional)

• stock_state: Get stock state (ticker required)

• insider_buy_sells: Get insider buy/sells for stock (ticker required; limit optional)

• ownership: Get ownership data (ticker required; limit optional)

• tickers_by_sector: Get tickers in sector (sector required)

• ticker_exchanges: Get mapping of all tickers to their exchanges (no params required)

Access UnusualWhales option contract data including flow, historic prices, intraday data, and volume profiles.

Available actions:

• flow: Get option contract flow (id required; side, min_premium, limit, date optional)

• historic: Get historic option contract data (id required; limit optional)

• intraday: Get intraday option contract data (id required; date optional)

• volume_profile: Get volume profile for option contract (id required; date optional)

The 'id' parameter is the option contract symbol (e.g., AAPL240119C00150000).

Access UnusualWhales market-wide data including market tide, sector ETFs, economic calendar, FDA calendar, and more.

Available actions:

• market_tide: Get market tide data showing net premium flow (date optional; otm_only, interval_5m optional)

• sector_tide: Get sector-specific tide (sector required; date optional)

• etf_tide: Get ETF-based tide (ticker required; date optional)

• sector_etfs: Get SPDR sector ETF statistics

• economic_calendar: Get economic calendar events

• fda_calendar: Get FDA calendar (announced_date_min/max, target_date_min/max, drug, ticker, limit optional)

• correlations: Get correlations between tickers (tickers required; interval, start_date, end_date optional)

• insider_buy_sells: Get total insider buy/sell statistics (limit optional)

• oi_change: Get top OI changes (date, limit, order optional)

• spike: Get SPIKE values (date optional)

• top_net_impact: Get top tickers by net premium (date, issue_types, limit optional)

• total_options_volume: Get total market options volume (limit optional)

Access UnusualWhales options flow data including flow alerts, full tape, net flow, group flow, and lit exchange flow.

Available actions:

• flow_alerts: Get flow alerts with extensive filtering options

• full_tape: Get full options tape for a date (date required)

• net_flow_expiry: Get net flow by expiry date (date optional)

• group_greek_flow: Get greek flow (delta & vega) for a flow group (flow_group required; date optional)

• group_greek_flow_expiry: Get greek flow by expiry for a flow group (flow_group, expiry required; date optional)

• lit_flow_recent: Get recent lit exchange trades across the market

• lit_flow_ticker: Get lit exchange trades for a specific ticker (ticker required)

Flow groups: airline, bank, basic materials, china, communication services, consumer cyclical, consumer defensive, crypto, cyber, energy, financial services, gas, gold, healthcare, industrials, mag7, oil, real estate, refiners, reit, semi, silver, technology, uranium, utilities

Flow alerts filtering options include: ticker, premium range, volume range, OI range, DTE range, and more. Lit flow filtering options include: premium range, size range, volume range, and timestamp filters.

Access UnusualWhales darkpool trade data.

Available actions:

• recent: Get recent darkpool trades across the market

• ticker: Get darkpool trades for a specific ticker

Filtering options include premium range, size range, and volume range.

Access UnusualWhales congress trading data including trades by congress members.

Available actions:

• recent_trades: Get recent trades by congress members

• late_reports: Get recent late reports by congress members

• congress_trader: Get trades by a specific congress member (name required)

Access UnusualWhales insider trading data including transactions and flow.

Available actions:

• transactions: Get insider transactions with filters. Use ticker_symbol for comma-separated tickers (e.g., AAPL,INTC)

• sector_flow: Get aggregated insider flow for a sector (sector required)

• ticker_flow: Get aggregated insider flow for a ticker (ticker required)

• insiders: Get all insiders for a ticker (ticker required)

Access UnusualWhales institutional holdings and ownership data.

Available actions:

• list: List institutions with filters

• holdings: Get holdings for an institution (name required)

• activity: Get trading activity for an institution (name required)

• sectors: Get sector exposure for an institution (name required)

• ownership: Get institutional ownership of a ticker (ticker required)

• latest_filings: Get latest institutional filings

Access UnusualWhales earnings data including premarket and afterhours earnings schedules.

Available actions:

• premarket: Get premarket earnings for a date

• afterhours: Get afterhours earnings for a date

• ticker: Get historical earnings for a ticker (ticker required)

Access UnusualWhales ETF data including holdings, exposure, inflows/outflows, and weights.

Available actions:

• info: Get ETF information (ticker required)

• holdings: Get ETF holdings (ticker required)

• exposure: Get ETFs that hold a ticker (ticker required)

• in_outflow: Get ETF inflow/outflow data (ticker required)

• weights: Get sector and country weights (ticker required)

Access UnusualWhales screeners for stocks, options, and analysts.

Available actions:

• stocks: Screen stocks with various filters

• option_contracts: Screen option contracts with filters

• analysts: Screen analyst ratings

Access UnusualWhales short selling data including short interest, FTDs, and volume.

Available actions:

• data: Get short data for a ticker (ticker required)

• ftds: Get failure to deliver data (ticker required)

• interest_float: Get short interest as percent of float (ticker required)

• volume_ratio: Get short volume and ratio (ticker required)

• volumes_by_exchange: Get short volumes by exchange (ticker required)

Access UnusualWhales seasonality data showing historical performance patterns.

Available actions:

• market: Get market-wide seasonality data

• performers: Get top/bottom performers for a month (month required, 1-12) Optional filters: min_years, ticker_for_sector, s_p_500_nasdaq_only, min_oi, limit, order, order_direction

• monthly: Get monthly seasonality for a ticker (ticker required)

• year_month: Get year-month breakdown for a ticker (ticker required)

Access UnusualWhales news headlines.

Available actions:

• headlines: Get news headlines with optional filters (ticker, sources, search_term, major_only, page)

Access UnusualWhales user alerts and configurations.

Available actions:

• alerts: Get triggered alerts for the user

• configurations: Get alert configurations

Access UnusualWhales politician portfolio and trading data.

Available actions:

• people: List all politicians

• portfolio: Get a politician's portfolio (politician_id required; optional: aggregate_all_portfolios)

• recent_trades: Get recent politician trades (optional: date, ticker, politician_id, filter_late_reports, disclosure_newer_than, disclosure_older_than, transaction_newer_than, transaction_older_than)

• holders: Get politicians holding a ticker (ticker required; optional: aggregate_all_portfolios)

• disclosures: Get annual disclosure file records (optional: politician_id, latest_only, year)