Unusual Whales

Get the latest analyst ratings with price targets. Use this to filter analyst activity by ticker, rating action, or recommendation. Returns the same analyst rating data as the Public API analyst screener, including ticker, analyst, firm, recommendation, action, target, timestamp, and sector.

Get the at-the-money call and put option contracts nearest the underlying price for each requested expiration. Use this for concise ATM comparisons across one or more specific expirations. Do not use this when the user needs a broad strike range or the full chain for an expiration. Open-interest interpretation: - Open Interest Changes need confirmation from the next morning's updated open-interest data. - Do not assume option volume equals open interest or new positioning. Volume can suggest possible activity, but it can include opening, closing, spread, roll, hedge, or same-day trades that do not become new OI. - When OI confirmation is unavailable, describe volume-over-OI or high-volume activity as unconfirmed until the next OI update.

enables precise screening and sorting of balance sheet data, covering critical indicators of liquidity, solvency, and capital structure. It provides deep visibility into asset composition—from cash and inventory to goodwill and PPE—alongside a detailed breakdown of current and long-term liabilities. By organizing these core accounting fields, the tool allows for the rapid assessment of shareholder equity, debt obligations, and overall financial stability across specific fiscal periods Supports filtering by `min_<field>` / `max_<field>` on any numeric or date field and by `tickers` for a specific symbol list. Combine multiple criteria in a single call instead of issuing repeated ranked calls.

Get detailed balance sheet data for a ticker, including total assets/liabilities, current/non-current breakdowns, cash & equivalents, inventory, receivables, PP&E, intangibles, goodwill, debt structure (short-term, long-term, lease obligations), shareholder equity, retained earnings, treasury stock, and shares outstanding. Use this for balance sheet analysis, debt structure review, and asset composition.

screening and sorting of cash flow data by categorizing activities into operating, investing, and financing streams. It provides visibility into critical capital movements, including capital expenditures, dividend payouts, debt issuances, and stock-based compensation, to track how a company generates and spends its cash. By organizing these detailed line items across fiscal periods, the tool facilitates a clear assessment of a firm's liquidity, reinvestment strategies, and overall cash position Supports filtering by `min_<field>` / `max_<field>` on any numeric or date field and by `tickers` for a specific symbol list. Combine multiple criteria in a single call instead of issuing repeated ranked calls.

Get detailed cash flow statement data for a ticker, including operating/investing/financing cashflows, capital expenditures, stock buyback payments, dividend payouts, stock-based compensation, debt issuance/repayment, depreciation, and changes in working capital. Use this for free cash flow analysis, capital allocation review, and cash generation assessment.

Get central banks with their latest policy rate and historical rate series.

Get option chains for a ticker at a specific expiry date. Returns chain rows plus current underlying price data for the given expiry date. Use this when looking at a specific expiry date and want to see the chains for that expiry. Do not use this for upcoming earnings dates/calendars or analyst-rating actions. Open-interest interpretation: - Open Interest Changes need confirmation from the next morning's updated open-interest data. - Do not assume option volume equals open interest or new positioning. Volume can suggest possible activity, but it can include opening, closing, spread, roll, hedge, or same-day trades that do not become new OI. - When OI confirmation is unavailable, describe volume-over-OI or high-volume activity as unconfirmed until the next OI update.

Get company profile and metadata for a ticker.

Get the latest trades made by members of Congress. Filter by ticker or return trades transacted on or before a given date.

Get stock correlation pairs based on historical price movement to find similarly performing or inversely moving stocks. Use this when the user wants statistically similar or opposite movers, hedging candidates, or pair-trade idea generation from one or more seed tickers. Do not use this for real-time price action, intraday chart analysis, fundamentals, options flow, or catalyst/event lookups. When to use examples: "What names are most correlated with NVDA?", "Show me inversely correlated stocks to XLE", "Find pair-trade candidates for AAPL and MSFT." When not to use examples: "What is AAPL doing right now?", "Show me TSLA options sweeps", "What are this week's earnings catalysts for semis?"

Get OHLC candle data for a crypto pair. Use this for crypto price action, historical candles, intraday crypto bars, and OHLCV analysis on pairs like BTC-USD or ETH-USD. Returns pair, open, high, low, close, volume, start_time, and timestamp.

Get the latest state for a crypto pair, including 24-hour OHLCV data. Use this for current crypto pair snapshots, latest 24h open/high/low/close/volume, or quick pair state checks for pairs like BTC-USD or ETH-USD. Returns pair, date, open_24h, high_24h, low_24h, close_24h, volume_24h, and timestamp.

Get the supported `config` properties for one custom alert `noti_type`. Call this before `save_custom_alert` when creating or editing a custom alert. The response contains only the filter properties for the requested `noti_type`. For a named stock watchlist call `get_users_stock_watchlists`. Preserve its returned `id`. The accepted `watchlist` and `watchlists` input aliases may not appear in the returned properties. If `symbols` advertises `list` then submit an array of ticker symbols. Never submit the literal string `list`.

Get the custom-alert Query language grammar. Call without a target for an overview of available targets, syntax, operators, functions, scopes, and examples. Call with a target for its complete field reference before using `input` with `save_custom_alert`.

Get the calling user's saved custom alert configurations. Use this when the user asks to view, list, manage, edit, pause, resume, or inspect their existing custom alerts.

Screen and rank off-exchange (dark pool/TRF) stock prints by size, premium, market-cap, and session context. Use this for dark-pool block-flow discovery and filtering, not listed-options contract activity. Supports session scoping (`market_times`) and relative-size filters versus daily/30-day volume. This tool maps directly to the `/large-trades?tab=dark-pool` page. If current page info says the user is on `/large-trades` with `tab=dark-pool`, treat that page's query params as the current dark pool filter state unless the user explicitly asks for a separate new filter. Apply the user's requested changes to the current dark pool filters, then call this tool with only valid filter args. When a user wants to build, edit, open, or share a dark pool flow filter, use these argument names as the canonical filter keys and offer a clickable deep link to `/large-trades` with `tab=dark-pool` plus matching query params. `tab=dark-pool` is required route state for the page link, not a data-tool filter argument. When the user asks to explain, summarize, or analyze the current page or the data displayed on it, use the current page URL to identify the matching tool and call it before answering. Reconstruct the displayed query using only URL parameters that are valid arguments in this tool's schema. Ignore authentication tokens, saved-view names, navigation state, and other non-tool parameters. Treat tool results as the source of truth for market data. Use page or image context only to explain visual presentation that the tool results do not represent. Keep the tool-call args and the page-link query params aligned as closely as possible. Never invent filter keys that are not part of this tool schema. Omit nil, blank, false-by-omission, or unspecified params from the page link. Serialize booleans in page links as lowercase `true` or `false`. Serialize arrays in page links as repeated bracket params, for example `market_times[]=pre_market&market_times[]=market_hours`, while still passing arrays to the tool itself. When returning a page link, briefly summarize the active filters/configs and then provide a clickable link in this format: [Open in Dark Pool Flow](https://unusualwhales.com/large-trades?tab=dark-pool&...query params...)

Get per-price-level volume concentration for a single ticker on the latest market session, including stock dark-pool/regular volume and options call/put volume at each price. Use this for price-level concentration and support/resistance context on one symbol, not for scanning many tickers or listing individual dark-pool prints.

Get earnings history for a ticker with reported EPS, estimated EPS, surprise amount, surprise percentage, report date, and report timing (pre/post market). Use this for earnings surprise analysis, EPS trends, and beat/miss history.

Get earnings call transcript text for a company ticker. Use this when the user asks for transcript content, management commentary, prepared remarks, or Q&A excerpts. Provide both quarter and year to target a specific period; if either is missing, returns the most recent transcript. Do not use this for upcoming earnings dates/calendars or analyst-rating actions.

screen and sort corporate earnings performance by tracking reported versus estimated earnings per share (EPS). It allows for rapid analysis of earnings surprises—both in absolute value and percentage—while organizing data by report dates and timing. By focusing on these core performance metrics, the tool helps identify significant market-moving events and historical trends in analyst accuracy. `order_by` and `order_direction` are optional. If `order_by` is omitted, no explicit user-requested sort is applied. If `order_by` is provided without `order_direction`, the downstream defaults to descending order. Supports filtering by `min_<field>` / `max_<field>` on any numeric or date field and by `tickers` for a specific symbol list. Combine multiple criteria in a single call instead of issuing repeated ranked calls.

Get a technical indicator time series for any ticker, including international stocks, OTC, and others that may lack intraday candle data. Use this as a fallback when get_ticker_indicator_series returns empty data, or for daily/weekly indicators with long history (20+ years). Supports an extended technical indicator function set covering 50+ indicators.

Get available alert rule definitions.

Screen for options flow alert hits generated by predefined unusual-activity rules. Covers repeated-hits/fill-pattern clusters, floor trades by market-cap bucket, sweeps-followed-by-floor, volume-over-OI, low-historic-volume floor, and OTM earnings floor. Best for rule-triggered event discovery and filtering, not for full raw tape reconstruction or every individual print. Open-interest interpretation: - Open Interest Changes need confirmation from the next morning's updated open-interest data. - Do not assume option volume equals open interest or new positioning. Volume can suggest possible activity, but it can include opening, closing, spread, roll, hedge, or same-day trades that do not become new OI. - When OI confirmation is unavailable, describe volume-over-OI or high-volume activity as unconfirmed until the next OI update. This tool maps directly to the `/option-flow-alerts` page. If current page info says the user is on `/option-flow-alerts`, treat that page's query params as the current flow alerts filter state unless the user explicitly asks for a separate new filter. Apply the user's requested changes to the current flow alerts filters, then call this tool with only valid filter args. When a user wants to build, edit, open, or share an option flow alerts filter, use these argument names as the canonical filter keys and offer a clickable deep link to `/option-flow-alerts` with matching query params. When the user asks to explain, summarize, or analyze the current page or the data displayed on it, use the current page URL to identify the matching tool and call it before answering. Reconstruct the displayed query using only URL parameters that are valid arguments in this tool's schema. Ignore authentication tokens, saved-view names, navigation state, and other non-tool parameters. Treat tool results as the source of truth for market data. Use page or image context only to explain visual presentation that the tool results do not represent. Keep the tool-call args and the page-link query params aligned as closely as possible. Never invent filter keys that are not part of this tool schema. Omit nil, blank, false-by-omission, or unspecified params from the page link. Serialize booleans in page links as lowercase `true` or `false`. Serialize arrays in page links as repeated bracket params, for example `rule_name[]=VolumeOverOi&issue_types[]=Common%20Stock`, while still passing arrays to the tool itself. When returning a page link, briefly summarize the active filters/configs and then provide a clickable link in this format: [Open in Option Flow Alerts](https://unusualwhales.com/option-flow-alerts?...query params...)

Get aggregated option flow for a ticker grouped by expiration date for the last trading day. Returns call/put premium, ask-side and bid-side premium, volume, OTM volume/premium, and trade counts per expiry. Use this for expiry-level flow concentration and directional premium comparisons, not for individual trade tape prints.

Get aggregated option flow for a ticker grouped by strike for a trading day. Returns call/put premium, ask-side and bid-side premium, volume, trade counts, timestamp, and ticker per strike. Use this for strike-level flow concentration and directional premium comparisons, not for individual trade tape prints.

Get a flow watchlist by ID.

Get filing-based fundamentals for a ticker, including earnings, revenue, cash flow, dividends, EPS, balance sheet trends, and revenue breakdowns by product or geography. Use this for company financial statement analysis and medium/long-term fundamental context. Do not use this for real-time price action, intraday options flow, or event-calendar style upcoming catalysts.

Get a ticker's Greek exposure grouped by option expiry for a market date, including call and put gamma, delta, charm, vanna, and DTE values. Use this for current or historical ticker-level gamma exposure (GEX) broken down by expiration date.

Get a ticker's Greek exposure grouped by strike price for a market date, including call and put gamma, delta, charm, and vanna values. Use this for current or historical ticker-level gamma exposure (GEX) broken down by option strike.

Get a ticker's Greek exposure grouped by strike price for a specific option expiry and market date, including call and put gamma, delta, charm, vanna, and DTE values. Use this for current or historical ticker-level gamma exposure (GEX) by strike within one expiration date.

Get a ticker's historical daily Greek exposure, including call and put gamma, delta, charm, and vanna values. Use this for ticker-level gamma exposure (GEX) or dealer Greek exposure over a date range.

Get a flow group's minute-by-minute greek flow for a market day, including delta flow, vega flow, call/put premium, volume, and transaction counts. Use this for intraday delta and vega flow trends across thematic or sector flow groups such as airline, bank, semi, mag7, technology, energy, or financial services.

Get a flow group's minute-by-minute greek flow for a specific option expiry and market day, including delta flow, vega flow, call/put premium, volume, and transaction counts. Use this for intraday delta and vega flow trends by expiry across thematic or sector flow groups such as airline, bank, semi, mag7, technology, energy, or financial services.

Get a ticker's minute-by-minute Greek flow for a market day, including total and directional delta and vega flow, OTM flow, volume, and transaction counts. Use this for intraday delta and vega flow trends for a specific ticker such as SPY, AAPL, TSLA, or NVDA.

Get daily historical time-series for a single option contract, including volume, open interest, OI deltas, OHLC price fields, and IV. Use for contract-specific trend and delta questions (for example, largest OI increase over the last N days). Open-interest interpretation: - Open Interest Changes need confirmation from the next morning's updated open-interest data. - Do not assume option volume equals open interest or new positioning. Volume can suggest possible activity, but it can include opening, closing, spread, roll, hedge, or same-day trades that do not become new OI. - When OI confirmation is unavailable, describe volume-over-OI or high-volume activity as unconfirmed until the next OI update.

Get the implied volatility term structure for a ticker on a market date. Returns each option expiration's volatility, implied move, implied move percentage, and days to expiration. Use this to compare near-term and longer-dated implied volatility or identify contango and backwardation in a ticker's option volatility curve.

provides granular filtering and sorting capabilities for corporate earnings data across key financial metrics, including revenue, operating expenses, and profitability indicators like EBIT and EBITDA. It enables users to analyze specific fiscal periods by comparing net income, debt expenses, and R&D investments to evaluate a company's financial health and operational efficiency, and to identify of trends in both top-line growth and bottom-line performance. Supports filtering by `min_<field>` / `max_<field>` on any numeric or date field and by `tickers` for a specific symbol list. Combine multiple criteria in a single call instead of issuing repeated ranked calls.

Get detailed income statement data for a ticker, including revenue, cost of revenue, gross profit, operating income, EBIT, EBITDA, net income, R&D expenses, SG&A, depreciation & amortization, interest income/expense, tax expense, and comprehensive income. Use this for deep income statement analysis beyond what get_fundamental_breakdown provides.

Get all known SEC insiders associated with a ticker, including insider CIK, name, slug, person flag, and logo URL when available. Returns the same data as the public API /api/insider/{ticker} endpoint.