optionwhales_skill

Overview

This skill queries real-time option flow intelligence to surface institutional intent momentum, clustered trades, and abnormal option activity. It returns ranked tickers, per-ticker cluster details, momentum time series, and live abnormal trades to help interpret directional conviction and volatility positioning. A free API tier provides limited top results; Pro unlocks full tickers, WebSocket streaming, and historical sessions.

How this skill works

The skill calls the OptionWhales Pro API endpoints to fetch current flow rankings, ticker-level cluster and time-series detail, momentum rankings, and abnormal trades. It analyzes clustered option trades for intent (Directional/Gamma/LongVol/ShortVol/Mixed), direction bias, confidence, and fast/slow momentum. For Pro users it can stream real-time abnormal trades via WebSocket and retrieve historical session snapshots.

When to use it

• Check today’s institutional option flow for a specific ticker (e.g., AAPL, TSLA).
• Detect unusual or large option trades appearing in real time or by session.
• Rank top momentum tickers by recent acceleration in option-driven conviction.
• Investigate clusters and trade-level details to infer institutional strategy and exposure.
• Retrieve historical sessions to compare intraday flow vs. final post-close data.

Best practices

• Provide an API key; free keys return top 3 tickers and last 5 abnormal trades, Pro keys return full access.
• Use flow/current for quick market-wide rankings and flow/<TICKER> for detailed cluster and time-series analysis.
• Combine momentum_fast and momentum_slow to spot both recent spikes and sustained trends.
• Subscribe to the WebSocket abnormal-trades stream for low-latency alerts on large or unusual trades (Pro only).
• Respect rate limits: free (10 req/min, 200/day) vs. Pro (60 req/min, 5000/day).

Example use cases

• "Is there bullish momentum in TSLA today?" → query current flow for TSLA and check direction_bias and momentum.
• "Show me unusual options activity now" → fetch current abnormal-trades or connect to the WebSocket stream.
• "What are the top momentum tickers this session?" → call momentum/rankings sorted by |momentum_fast|.
• "Compare intraday vs final flow for a date" → fetch a historical session and inspect ticker detail.
• "Inspect cluster strategies on AAPL" → request flow/current/AAPL to view clusters, cluster_trades, and time_series.