ALL WITH NATURAL LANGUAGE. POWERED BY TTG AI M.A.R.I
True Trading Group & Unusual Whales join forces to empower retail traders to uncover unusual trades that predict market moves—before they make the headlines. The data from Unusual Whales (options flow, dark‑pool prints, order‑flow and IV analytics) combined with TTG AI's M.A.R.I turns 100 tools into clear, actionable trade signals so you can learn faster, trade smarter, and profit sooner.
Category | Endpoint | What it shows | How to use | Key Filters | Best For |
---|---|---|---|---|---|
Darkpool | Recent Darkpool Tape /api/darkpool/recent | Latest off-exchange (ATS) prints across tickers | Spot fresh, large prints as support/resistance magnets; trade retests or breakouts around them | limit, date, min_premium, min_size, min_volume | Day, Swing |
Darkpool | Ticker Darkpool Tape /api/darkpool/{ticker} | Off-exchange prints for a specific ticker | Map big levels for your ticker; confluence with lit volume and options levels | ticker, date, newer_than, older_than, min_premium, min_size, min_volume, limit | Day, Swing |
Options Flow | Recent Flow (Ticker) /api/stock/{ticker}/flow-recent | Latest options transactions summary for a ticker | Follow ask-side bursts or sustained net premium to time momentum entries | ticker, side, min_premium | Day, Swing |
Options Flow | Flow by Strike /api/stock/{ticker}/flow-per-strike | Distribution of flow across strikes | Identify strike magnets and crowding for pinning/mean reversion | ticker, date | Day, Swing |
Options Flow | Intraday Flow by Strike /api/stock/{ticker}/flow-per-strike-intraday | Intraday flow heat by strike with metric | Time entries around strike hotspots; watch momentum shifts | ticker, date, filter (NetPremium/Volume/Trades) | Day |
Options Flow | Flow by Expiry /api/stock/{ticker}/flow-per-expiry | Flow distribution across expiries | Focus where risk is concentrated (weeklies vs monthlies) | ticker | Swing |
Options Flow | Flow Alerts (Ticker) /api/stock/{ticker}/flow-alerts | Notable prints for a given ticker | Trade only the best: large ask sweeps, opening flow, tight DTE | ticker, limit, is_ask_side, is_bid_side | Day |
Option Trades | Global Flow Alerts /api/option-trades/flow-alerts | Market-wide notable options prints | Build watchlists; filter for big sweeps on liquid names | ticker_symbol, min_premium/max_premium, is_sweep, is_floor, is_ask_side/is_bid_side, is_call/is_put, min_dte/max_dte, min_open_interest/max_open_interest, min_volume/max_volume, min_volume_oi_ratio/max_volume_oi_ratio, min_diff/max_diff, rule_name[], issue_types[], newer_than/older_than, limit | Day |
Option Trades | Full Options Tape (Day) /api/option-trades/full-tape/{date} | Full day options tape by date | Backtest intraday signals; study distribution and timing | date | Research, Swing |
Option Contract | Contract Intraday /api/option-contract/{id}/intraday | Intraday series for a specific option | Time entries/exits with contract price/greeks behavior | id, date | Day |
Option Contract | Contract History /api/option-contract/{id}/historic | Historical bars for an option | Validate edge; analyze movement around catalysts | id, limit | Research |
Option Contract | Contract Flow /api/option-contract/{id}/flow | Trades for a specific option | Confirm buying vs selling pressure on your contract | id, side, min_premium, date, limit | Day |
Option Contract | Volume Profile (Contract) /api/option-contract/{id}/volume-profile | Price-volume distribution | Identify value areas to scale in/out | id, date | Day, Swing |
Greeks/Exposure | Aggregate Options Exposure /api/stock/{ticker}/greek-exposure | Aggregate options exposures vs spot (e.g., gamma exposure) | Trade toward positive exposure magnets; avoid fighting large negative exposure | ticker, date, timeframe | Day, Swing |
Greeks/Exposure | Exposure by Expiry /api/stock/{ticker}/greek-exposure/expiry | Exposures broken out by expiry | See which expiry likely steers spot | ticker, date | Swing |
Greeks/Exposure | Exposure by Strike /api/stock/{ticker}/greek-exposure/strike | Exposures across strikes | Locate "magnet" strikes and resistance pockets | ticker, date | Day |
Greeks/Exposure | Exposure by Strike+Expiry /api/stock/{ticker}/greek-exposure/strike-expiry | Matrix of exposures (strike x expiry) | Align intraday plan with dominant nodes | ticker, expiry, date | Day |
Greeks/Exposure | Greek Flow (Ticker) /api/stock/{ticker}/greek-flow | Flow measured in greek units | Catch hedging pressure shifts (delta/gamma-heavy) | ticker, date | Day |
Greeks/Exposure | Greek Flow by Expiry /api/stock/{ticker}/greek-flow/{expiry} | Greek flow segmented by expiry | Target the expiry driving tape | ticker, expiry, date | Day |
Greeks | Chain Greeks Snapshot /api/stock/{ticker}/greeks | Per-strike greeks for a selected expiry | Build structured trades around skew and concentration | ticker, expiry, date | Swing |
IV & Skew | Interpolated IV Curve /api/stock/{ticker}/interpolated-iv | Smoothed IV across DTE curve | Decide buy vs sell premium; detect IV kinks | ticker, date | Swing |
IV & Skew | IV Rank /api/stock/{ticker}/iv-rank | Current IV vs history | Choose strategies (sell high IV rank, buy low) | ticker, date, timespan | Swing |
IV & Skew | Risk Reversal Skew (Hist) /api/stock/{ticker}/historical-risk-reversal-skew | Call vs put skew at chosen delta over time | Trade skew mean reversion or hedge tail risk | ticker, expiry, delta, date, timeframe | Swing |
Positioning | Max Pain /api/stock/{ticker}/max-pain | Max pain price for next expiry | Bias for pinning into OPEX; beware squeezes away from it | ticker, date | Swing |
Positioning | Net Premium Ticks /api/stock/{ticker}/net-prem-ticks | Intraday ticks of call/put net and volume | Time entries with bursts in net call/put demand | ticker, date | Day |
Positioning | NOPE /api/stock/{ticker}/nope | Net Options Position Effect gauge | Intraday bias and extremes for reversal vs trend days | ticker, date | Day |
Market | Market Tide /api/market/market-tide | Broad options flow breadth/pressure | Gauge risk-on/off; align index bias | date, otm_only, interval_5m | Day |
Market | Net Flow by Expiry /api/net-flow/expiry | Market-wide net flow segmented by expiry | Focus trading on hot expiries (0DTE vs monthly) | date, moneyness[], tide_type[], expiration[] | Day, Swing |
Market | Total Options Volume /api/market/total-options-volume | Aggregate options volume leaders | Build watchlist for liquid movers | limit | Day |
Market | OI Change (Market) /api/market/oi-change | Biggest OI changes market-wide | Find fresh positioning and possible gamma flips | date, limit, order | Swing |
Market | Top Net Impact /api/market/top-net-impact | Names with highest net options impact | Prioritize tickers with real capital flow | date, issue_types[], limit | Day |
Market | SPIKE Vol Index /api/market/spike | Volatility index series | Vol regime check for sizing and strategy selection | date | Swing |
Sector | Sector Tide /api/market/{sector}/sector-tide | Flow breadth by sector | Rotate to sectors with strongest options demand | sector, date | Swing |
ETF Tide | ETF Tide (Ticker) /api/market/{ticker}/etf-tide | Options tide for an ETF | Trade sector/ETF momentum and hedges | ticker, date | Swing |
Market | Correlations /api/market/correlations | Correlation matrix/time series | Risk management, pair trades, hedging | tickers, interval, start_date, end_date | Swing |
Market | Economic Calendar /api/market/economic-calendar | Upcoming macro events | Avoid landmines; position into/after catalysts | — | Day, Swing |
Market | FDA Calendar /api/market/fda-calendar | Drug approval and PDUFA dates | Biotech catalyst trades; avoid surprise gaps | announced_date_min/max, target_date_min/max, drug, ticker, limit | Swing |
Market | Insider Buy/Sell Totals /api/market/insider-buy-sells | Aggregate insider activity | Regime context; screen for insider-supported names | limit | Swing |
Market | Sector ETFs List /api/market/sector-etfs | List of sector ETFs | Quick reference for rotation and hedging | — | Swing |
OI/Volume | OI Change (Ticker) /api/stock/{ticker}/oi-change | Daily OI changes for a ticker | Confirm opening vs closing interest; validate flow | ticker, date, limit, order, page | Swing |
OI/Volume | OI per Expiry /api/stock/{ticker}/oi-per-expiry | OI distribution across expiries | Find crowded expiries and pin risk | ticker, date | Swing |
OI/Volume | OI per Strike /api/stock/{ticker}/oi-per-strike | OI distribution across strikes | Identify gamma walls and pin levels | ticker, date | Swing |
OI/Volume | Options Volume (Ticker) /api/stock/{ticker}/options-volume | Historic options volume stats | Spot increasing participation before moves | ticker, limit | Swing |
OI/Volume | Option Chains (Snapshot) /api/stock/{ticker}/option-chains | Full chain snapshot | Price strikes, check spreads, confirm liquidity | ticker, date | Day |
OI/Volume | Contracts Finder /api/stock/{ticker}/option-contracts | Filtered list of contracts | Surface best contracts (DTE, delta, vol>OI) | ticker, expiry, option_type, vol_greater_oi, exclude_zero_vol_chains, exclude_zero_dte, exclude_zero_oi_chains, maybe_otm_only, option_symbol[], limit, page | Day, Swing |
OI/Volume | ATM Chains /api/stock/{ticker}/atm-chains | ATM contracts for target expirations | Fast ATM selection for scalps/hedges | ticker, expirations[] | Day |
OI/Volume | Expiry Breakdown /api/stock/{ticker}/expiry-breakdown | Flow/volume by expiry (ticker) | Choose which expiry to trade for the setup | ticker, date | Day, Swing |
OI/Volume | Option Price Levels /api/stock/{ticker}/option/stock-price-levels | Derived price levels from options | Add to confluence map (pins/magnets) | ticker, date | Day, Swing |
OI/Volume | Volume & OI per Expiry /api/stock/{ticker}/option/volume-oi-expiry | Combined volume/OI stats by expiry | Track churn vs positioning by expiry | ticker, date | Swing |
Spot Exposure | Spot GEX (1m) /api/stock/{ticker}/spot-exposures | 1-minute spot exposure series | Intraday magnets; time reversions vs momentum | ticker, date | Day |
Spot Exposure | Spot GEX by Expiry+Strike /api/stock/{ticker}/spot-exposures/expiry-strike | Exposure grid by strike and expiry | Align entries at strongest nodes | ticker, expirations[], date, min_strike, max_strike, min_dte, max_dte, limit, page | Day |
Spot Exposure | Spot GEX by Strike /api/stock/{ticker}/spot-exposures/strike | Exposure by strike only | Fast view of intraday magnet strikes | ticker, date, min_strike, max_strike, limit, page | Day |
Price Levels | Off/Lit Price Levels /api/stock/{ticker}/stock-volume-price-levels | Volume-derived price levels incl. darkpool | Build S/R map; trade around confluence | ticker, date | Day, Swing |
Price Levels | Stock State Snapshot /api/stock/{ticker}/stock-state | One-stop state summary of the ticker | Quick bias check before entry | ticker | Day |
Volatility | Realized Volatility /api/stock/{ticker}/volatility/realized | Realized vol over chosen window | Pick strategy (premium sell vs buy) vs realized | ticker, date, timeframe | Swing |
Volatility | Volatility Stats /api/stock/{ticker}/volatility/stats | Summary stats (IV, RV, ranks) | Risk sizing and selection | ticker, date | Swing |
Volatility | IV Term Structure /api/stock/{ticker}/volatility/term-structure | IV across expiries | Spot contango/backwardation; choose DTE | ticker, date | Swing |
Chart | OHLC /api/stock/{ticker}/ohlc/{candle_size} | Historical candles by timeframe | Technical levels and trend context | ticker, candle_size, timeframe, end_date, date, limit | Day, Swing |
Reference | Companies in Sector /api/stock/{sector}/tickers | Ticker list by sector | Build sector watchlists | sector | Swing |
Reference | Ticker Info /api/stock/{ticker}/info | Snapshot fundamentals/profile | Filter tickers, context for trades | ticker | Swing |
Earnings | Premarket Earnings /api/earnings/premarket | Companies reporting premarket | Gap and volatility plays; IV crush plans | date, limit, page | Day, Swing |
Earnings | Afterhours Earnings /api/earnings/afterhours | Companies reporting afterhours | Plan post-close reactions and next-day plays | date, limit, page | Day, Swing |
Earnings | Historical Earnings (Ticker) /api/earnings/{ticker} | Past earnings results | Backtest reactions; IV behavior | ticker | Research, Swing |
ETFs | ETF Info /api/etfs/{ticker}/info | ETF overview | Validate product before trading | ticker | Swing |
ETFs | ETF Holdings /api/etfs/{ticker}/holdings | Constituents and weights | Trade components or hedge basket | ticker | Swing |
ETFs | ETF Exposure /api/etfs/{ticker}/exposure | Sector/Theme exposures | Align macro bets with exposures | ticker | Swing |
ETFs | Sector/Country Weights /api/etfs/{ticker}/weights | Weight breakdowns | Pair trades and rotations | ticker | Swing |
ETFs | ETF In/Outflows /api/etfs/{ticker}/in-outflow | Fund flows | Follow inflow momentum; beware outflows | ticker | Swing |
Insiders | Insider Transactions (Market) /api/insider/transactions | Recent Form 4 buys/sells | Track heavy insider accumulation; avoid sell waves | ticker_symbol, min/max_value, min/max_price, owner_name, sectors, industries, min/max_marketcap, market_cap_size, min/max_earnings_dte, min/max_amount, is_director, is_officer, is_ten_percent_owner, is_s_p_500, common_stock_only, transaction_codes[], security_ad_codes, limit, page | Swing |
Insiders | Ticker Insiders /api/insider/{ticker} | Insider roster and history | Confirm alignment with management | ticker | Swing |
Insiders | Ticker Insider Flow /api/insider/{ticker}/ticker-flow | Aggregated insider flow trend | Longer-term bias and conviction | ticker | Swing |
Insiders | Sector Insider Flow /api/insider/{sector}/sector-flow | Insider activity by sector | Sector rotation hints | sector | Swing |
Stock Insiders | Insider Buys/Sells (Ticker) /api/stock/{ticker}/insider-buy-sells | Recent buys/sells for a stock | Confluence for swing entries | ticker | Swing |
Institutions | Institutions List /api/institutions | Screen institutions by size/tags | Find smart money to follow | name, min_total_value, max_total_value, min_share_value, max_share_value, tags, order, order_direction, limit, page | Research |
Institutions | Latest 13F Filings /api/institutions/latest_filings | Recent filings list | Fresh position disclosures to track | name, date, order, order_direction, limit, page | Swing |
Institutions | Institution Activity /api/institution/{name}/activity | Transactions by an institution | Mirror or fade large moves | name, date, limit, page | Swing |
Institutions | Institution Holdings /api/institution/{name}/holdings | Full holdings snapshot/history | Identify core positions and rotations | name, date, start_date, end_date, security_types, order, order_direction, limit, page | Swing |
Institutions | Institution Sector Exposure /api/institution/{name}/sectors | Sector weights of an institution | Macro positioning tells | name, date, limit | Swing |
Ownership | Institutional Ownership (Ticker) /api/institution/{ticker}/ownership | Who owns the stock and trends | Confirm accumulation/distribution | ticker, date, start_date, end_date, tags, order, order_direction, limit, page | Swing |
Seasonality | Market Seasonality /api/seasonality/market | Seasonal patterns overview | Calendar bias and risk planning | — | Swing |
Seasonality | Month Performers /api/seasonality/{month}/performers | Best/worst performers for a month | Seasonal swing ideas; avoid weak months | month, min_years, s_p_500_nasdaq_only, ticker_for_sector, order, order_direction | Swing |
Seasonality | Ticker Monthly Avg /api/seasonality/{ticker}/monthly | Average monthly returns by ticker | Tilt sizing around favorable months | ticker | Swing |
Seasonality | Ticker Year-Month Grid /api/seasonality/{ticker}/year-month | Return per month per year | Find consistent seasonality, not just averages | ticker | Swing |
Shorts | Short Data Overview /api/shorts/{ticker}/data | Combined short stats | Gauge squeeze risk/opportunity | ticker | Swing |
Shorts | Short Interest & Float /api/shorts/{ticker}/interest-float | Short interest vs float | Identify crowded shorts | ticker | Swing |
Shorts | Short Volume & Ratio /api/shorts/{ticker}/volume-and-ratio | Daily short volume and ratio | Monitor pressure building/relieving | ticker | Swing |
Shorts | Short Vol by Exchange /api/shorts/{ticker}/volumes-by-exchange | Venue-level short volume | Spot anomalies (e.g., ATS spikes) | ticker | Swing |
Shorts | Failures to Deliver /api/shorts/{ticker}/ftds | FTD history | Elevated FTDs can precede squeezes | ticker | Swing |
News | News Headlines /api/news/headlines | Aggregated news headlines | Catalyst trading; sentiment check | sources, search_term, major_only, limit, page | Day |
Congress | Congress Trades /api/congress/recent-trades | Recently disclosed trades by members | Shadow high-conviction buys/sells | limit, date, ticker | Swing |
Congress | Late Congress Reports /api/congress/late-reports | Late-filed trades (tardy) | Sometimes higher alpha; track delayed disclosures | limit, date, ticker | Swing |
Congress | Congress by Trader /api/congress/congress-trader | Trades filed by specific member | Build "follow list" of skilled members | limit, date, ticker, name | Swing |
Politicians | Politicians List /api/politician-portfolios/people | All tracked politicians | Choose portfolios to follow | — | Research |
Politicians | Politician Portfolio /api/politician-portfolios/{politician_id} | Holdings/changes of a politician | Mirror high-conviction positions | politician_id | Swing |
Politicians | Holders of a Ticker /api/politician-portfolios/holders/{ticker} | Which politicians hold a ticker | Confidence/optics signal | ticker | Swing |
Group Flow | Greek Flow (Group) /api/group-flow/{flow_group}/greek-flow | Greek flow for a theme/sector | Rotate into groups with strong delta/gamma buying | flow_group ∈ {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}, date | Swing |
Group Flow | Greek Flow by Expiry (Group) /api/group-flow/{flow_group}/greek-flow/{expiry} | Same as above, segmented by expiry | Target weekly vs monthly rotation within groups | flow_group (same set), expiry, date | Swing |
Screener | Analyst Ratings /api/screener/analysts | Analyst rating changes | Momentum from upgrades/downgrades | ticker, action, recommendation, limit | Swing |
Screener | Hottest Option Chains /api/screener/option-contracts | Contract-level screener | Surface contracts with best characteristics | ticker_symbol, sectors[], min/max_underlying_price, is_otm, exclude_ex_div_ticker, min/max_dte, min/max_diff, min/max_strike, type, expiry_dates[], min/max_marketcap, min/max_volume, min/max_multileg_volume_ratio, min/max_floor_volume_ratio, min/max_perc_change, min/max_daily_perc_change, min/max_premium, min/max_avg_price, min/max_volume_oi_ratio, min/max_open_interest, min/max_floor_volume, vol_greater_oi, issue_types[], min/max_ask_perc, min/max_bid_perc, min/max_skew_perc, min/max_bull_perc, min/max_bear_perc, min/max_bid_side_perc_7_day, min/max_ask_side_perc_7_day, min/max_days_of_oi_increases, min/max_days_of_vol_greater_than_oi, min/max_iv_perc, min/max_delta/gamma/theta/vega, min/max_return_on_capital_perc, min/max_oi_change_perc, min/max_oi_change, min/max_volume_ticker_vol_ratio, min/max_sweep_volume_ratio, min/max_from_low_perc, min/max_from_high_perc, min/max_earnings_dte, min/max_transactions, min/max_close, order, order_direction, limit, page, date | Day, Swing |
Screener | Stock Screener /api/screener/stocks | Ticker-level screener | Find tickers with favorable flow/OI/vol profile | ticker, issue_types[], min/max_change, min/max_underlying_price, is_s_p_500, has_dividends, sectors[], min/max_marketcap, min/max_perc_3_day_total/call/put, min/max_perc_30_day_total/call/put, min/max_total_oi_change_perc, min/max_call_oi_change_perc, min/max_put_oi_change_perc, min/max_implied_move, min/max_implied_move_perc, min/max_volatility, min/max_iv_rank, min/max_volume, min/max_call_volume, min/max_put_volume, min/max_premium, min/max_call_premium, min/max_put_premium, min/max_net_premium, min/max_net_call_premium, min/max_net_put_premium, min/max_oi, min/max_oi_vs_vol, min/max_put_call_ratio, order, order_direction, min_stock_volume_vs_avg30_volume, max_avg30_volume, date, limit, page | Swing |