# Stock Option Trends Analyzer (`young_billionaires/stock-option-trends-analyzer`) Actor

AI-powered stock option market trend analyzer. Get real-time reasons for top gainers, losers, highest implied volatility and highest open interest stock options. Understand stock option price movements, volume spikes and market sentiment with clear, data-driven insights.

- **URL**: https://apify.com/young_billionaires/stock-option-trends-analyzer.md
- **Developed by:** [Young Billionaires](https://apify.com/young_billionaires) (community)
- **Categories:** AI, Automation, News
- **Features:** Limited permissions
- **Stats:** 110 total users, 4 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $380.00 / 1,000 option analyses

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 📊 Stock Options Trends Analyzer — AI-Powered Options Movement Explanations

> **Get instant, AI-powered explanations for stock options movements** | Analyze calls, puts & 1000+ options contracts | Real-time news sentiment analysis | Perfect for options traders, derivatives analysts, and volatility strategists

***

### 📈 What is Stock Options Trends Analyzer?

**Stock Options Trends Analyzer** is an AI-powered web scraping tool that extracts and analyzes **real-time stock options data** from Yahoo Finance, combining it with **news sentiment analysis** to explain why options are moving.

Stop wondering why certain options contracts are surging or why implied volatility is spiking. Get **data-backed explanations** for price movements in categories like **Top Gainers**, **Top Losers**, **Most Active**, **Highest Implied Volatility**, and **Highest Open Interest**.

#### ⚡ Quick Start — 3 Simple Steps

1️⃣ **Select Trend Category**: Choose from *Top Gainers*, *Top Losers*, *Most Active*, *Highest Implied Volatility*, or *Highest Open Interest*\
2️⃣ **Set Number of Options**: Pick how many top options contracts to analyze (1-25)\
3️⃣ **Get AI Explanations**: Receive structured insights combining price data, volume analysis, and news sentiment

***

### 🎯 Use Cases — Who Uses Stock Options Trends Analyzer?

| Use Case                            | Description                                                                                                      | Best For                                                       |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| 🔍 **Options Flow Analysis**        | Understand unusual options activity and what's driving large volume spikes with AI-generated explanations        | Options traders, flow analysts, hedge fund researchers         |
| 📈 **Volatility Trading Signals**   | Identify options with high implied volatility and sentiment shifts that may indicate trading opportunities        | Volatility traders, options strategists, derivatives desks     |
| 📰 **Market Sentiment Monitoring**  | Track options activity to gauge market sentiment and positioning before major events                              | Market analysts, event-driven traders, risk managers           |
| 🤖 **AI Training Data**             | Generate structured datasets combining options movements with explanatory text for ML model training              | AI/ML researchers, fintech developers, quantitative analysts   |
| 📱 **Trading App Integration**      | Power your options trading app, dashboard, or bot with real-time market insights via API                          | Mobile app developers, Discord/Telegram bot creators           |
| 💼 **Derivatives Research**         | Research why specific options contracts gained or lost value to inform trading strategies                         | Derivatives analysts, prop traders, options educators          |
| 📊 **Open Interest Analysis**       | Track open interest trends to identify where institutional money is positioning                                   | Institutional analysts, options flow traders, research firms   |

***

### ✨ Key Features

✅ **5 Trend Categories**: Top Gainers, Top Losers, Most Active, Highest Implied Volatility, Highest Open Interest\
✅ **AI-Powered Analysis**: GPT-4 analyzes news articles to explain options movements\
✅ **Real-Time Data**: Scrapes live options data from Yahoo Finance\
✅ **News Aggregation**: Collects relevant news from WSJ, Bloomberg, Yahoo Finance, Seeking Alpha\
✅ **Structured Output**: Get clean JSON data ready for integration into your apps\
✅ **Customizable Results**: Analyze 1-25 options contracts per run\
✅ **Comprehensive Metrics**: Strike price, expiration, bid/ask, volume, open interest\
✅ **API Ready**: Easy integration via Apify API for automated workflows

***

### 📤 Output Examples

#### Top Gainers — Why Options Are Rising

Discover the reasons behind today's biggest options winners

**Example Output:** *Top Gainers*

🏷 Symbol: TSLA250117C00250000

💰 Underlying: TSLA

💲 Price: $12.45

📈 Change: +4.82 (+63.21%)

🎯 Strike Price: $250.00

📅 Expiration: 2025-01-17

💵 Bid/Ask: $12.30 / $12.60

🔊 Volume: 45,230

📊 Open Interest: 128,450

**Reasons:**

Underlying stock surge: Tesla shares rallied 8% on strong delivery numbers, boosting call option premiums.

Earnings anticipation: Increased speculation ahead of quarterly earnings drove call buying activity.

Technical breakout: The underlying stock broke above key resistance, triggering momentum buying in options.

Short squeeze dynamics: High short interest in the underlying created upward pressure on call options.

Institutional positioning: Unusual options activity suggests large players are accumulating bullish positions.

```json
[
  {
	"module": "options",
	"view": "gainers",
	"entity": {
	  "symbol": "TSLA250117C00250000",
	  "name": "TSLA Jan 2025 250.000 call",
	  "stockSymbol": "TSLA",
	  "strikePrice": 250.00,
	  "expirationDate": "2025-01-17",
	  "price": 12.45,
	  "change": 4.82,
	  "changePercentual": 63.21,
	  "bid": 12.30,
	  "ask": 12.60,
	  "volume": 45230,
	  "openInterest": 128450
	},
	"explanation": {
	  "reasons": [
		"Tesla shares rallied 8% on strong delivery numbers, boosting call option premiums +63.21%.",
		"Increased speculation ahead of quarterly earnings drove significant call buying activity.",
		"Technical breakout above key resistance triggered momentum buying in options.",
		"High short interest in the underlying created upward pressure on call options.",
		"Unusual options activity with 45K volume suggests institutional bullish positioning."
	  ]
	}
  },
  ...
]
```

#### Top Losers — Why Options Are Falling

Choose the **Top Losers** category to understand why certain options are falling and what's driving bearish sentiment — whether it's time decay, underlying stock weakness, or volatility crush after events.

#### Most Active — Unusual Volume Analysis

Analyze options with the **Most Active** category to uncover unusual trading volumes and what's fueling the activity. High volume often indicates significant market events, earnings plays, or large institutional positioning.

#### Highest Implied Volatility — Volatility Spikes

Select **Highest Implied Volatility** to identify options with elevated IV and understand the catalysts — whether it's pending earnings, FDA decisions, merger announcements, or other binary events.

#### Highest Open Interest — Where the Money Is

See where the big money is positioned by selecting **Highest Open Interest**. Identify key strike prices where traders have concentrated their bets and understand the underlying thesis.

***

### 📥 Input Configuration

```json
{
    "trendType": "most-active", // Options: most-active | gainers | losers | highest-implied-volatility | highest-open-interest
    "optionsAmount": 10 // Number of options to analyze (1-25)
}
```

**Input Parameters:**

- `trendType` (required): The trend category to analyze
  - `most-active` — Options with highest trading volume
  - `gainers` — Options with highest % gains
  - `losers` — Options with highest % losses
  - `highest-implied-volatility` — Options with elevated implied volatility
  - `highest-open-interest` — Options with largest open interest positions
- `optionsAmount` (required): Number of top options to analyze (1-25)

***

### 🔍 How It Works — The Technology

#### 1. Real-Time Data Scraping

The actor scrapes live stock options data from Yahoo Finance, extracting strike prices, expiration dates, bid/ask spreads, volume, open interest, and performance metrics for top options contracts.

#### 2. News Aggregation

For each option's underlying stock, we collect relevant news articles from Google News, pulling from trusted sources like:

- [The Wall Street Journal](https://www.wsj.com/) — Financial news & analysis
- [Bloomberg](https://www.bloomberg.com/) — Markets & derivatives coverage
- [Yahoo Finance](https://finance.yahoo.com/) — Options data & news
- [Seeking Alpha](https://seekingalpha.com/) — Options research & analysis

#### 3. AI Sentiment Analysis

Our GPT-4 powered AI analyzes news articles, identifying key events, sentiment shifts, and market catalysts that explain the option's price movement and the underlying stock's dynamics.

#### 4. Structured Output

Get clean, structured JSON data combining quantitative metrics with qualitative AI-generated explanations.

***

### 📊 Options Metrics Included

| Metric             | Description                                         | Use Case                            |
| ------------------ | --------------------------------------------------- | ----------------------------------- |
| **Symbol**         | Full options symbol (e.g., TSLA250117C00250000)     | Identification                      |
| **Name**           | Human-readable option name                          | Display & reporting                 |
| **Stock Symbol**   | Underlying stock ticker                             | Underlying reference                |
| **Strike Price**   | Price at which option can be exercised              | Strike level analysis               |
| **Expiration**     | Options contract expiration date                    | Time to expiry tracking             |
| **Price**          | Current option premium in USD                       | Real-time valuation                 |
| **Change**         | Absolute price change                               | Dollar movement tracking            |
| **Change %**       | Percentage price change                             | Relative performance                |
| **Bid**            | Current bid price                                   | Liquidity & spread analysis         |
| **Ask**            | Current ask price                                   | Liquidity & spread analysis         |
| **Volume**         | Current trading volume                              | Activity & interest measure         |
| **Open Interest**  | Total outstanding contracts                         | Positioning & sentiment indicator   |

***

### 🔗 Integration & API Usage

#### Run via Apify API

```javascript
const { ApifyClient } = require('apify-client');

const client = new ApifyClient({
    token: 'YOUR_APIFY_TOKEN',
});

const input = {
    trendType: 'highest-implied-volatility',
    optionsAmount: 10,
};

const run = await client.actor('RJhSsPJyNyiKBirSl').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(items);
```

#### Python Integration

```python
from apify_client import ApifyClient

client = ApifyClient('YOUR_APIFY_TOKEN')

run_input = {
    "trendType": "most-active",
    "optionsAmount": 15
}

run = client.actor("RJhSsPJyNyiKBirSl").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

#### Schedule Automated Runs

Set up scheduled runs on Apify to get daily options analysis delivered automatically. Perfect for:

- Pre-market options flow analysis
- Automated unusual activity alerts
- Volatility monitoring reports
- Options trading newsletter content

***

### 💡 Why Choose Stock Options Trends Analyzer?

🎯 **Save Time**: No more manually researching why options moved\
🤖 **AI-Powered**: Leverages GPT-4 for intelligent news analysis\
📊 **Comprehensive**: Combines quantitative data with qualitative insights\
🔄 **Automated**: Run via API or schedule for automated workflows\
💰 **Cost-Effective**: Pay only for what you use on Apify platform\
🚀 **Fast**: Get results in seconds, not hours\
📈 **Actionable**: Use insights for options trading, flow analysis, or volatility strategies

***

### ❓ FAQ

**Q: How often is the data updated?**\
A: The actor scrapes real-time data from Yahoo Finance and Google News each time it runs, ensuring you always get the latest information.

**Q: Can I analyze specific options contracts?**\
A: Currently, the actor focuses on trending categories (most active, gainers, etc.). For specific contracts, we recommend running multiple category searches or filtering results.

**Q: What types of options are covered?**\
A: The tool covers equity options on major US stocks, including calls and puts across various strike prices and expirations.

**Q: What's the data format?**\
A: Output is provided in clean JSON format, compatible with any programming language and easily importable to databases, spreadsheets, or analytics tools.

**Q: Is this financial advice?**\
A: No. This tool provides data and analysis to help you understand options movements, but it does not constitute financial advice. Options trading involves significant risk.

**Q: Can I use this for commercial purposes?**\
A: Yes! You can integrate this into your trading platforms, options flow tools, research systems, or any commercial application.

***

### ⚠️ Disclaimer

> This tool is designed to help you understand stock options movements better, but it does **not** provide financial advice or trading recommendations. Options trading involves substantial risk of loss and is not suitable for all investors. Always conduct your own research and consult with a qualified financial advisor before making any trading decisions.

***

### 🆘 Support & Resources

- 📚 [Apify Documentation](https://docs.apify.com/)
- 💬 [Apify Discord Community](https://discord.com/invite/jyEM2PRvMU)
- 🐛 Report issues via Apify Console

# Actor input Schema

## `trendType` (type: `string`):

Choose the type of trend for stock options to analyze

## `optionsAmount` (type: `integer`):

Number of stock options to analyze within the selected trend category

## Actor input object example

```json
{
  "trendType": "most-active",
  "optionsAmount": 5
}
```

# Actor output Schema

## `trendExplanations` (type: `string`):

Summary view of stock options data with key metrics

## `analyzedOptions` (type: `string`):

AI-generated analysis with reasoning for each option

## `rawData` (type: `string`):

Raw data structure with all fields

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "trendType": "most-active",
    "optionsAmount": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("young_billionaires/stock-option-trends-analyzer").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "trendType": "most-active",
    "optionsAmount": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("young_billionaires/stock-option-trends-analyzer").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "trendType": "most-active",
  "optionsAmount": 5
}' |
apify call young_billionaires/stock-option-trends-analyzer --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,young_billionaires/stock-option-trends-analyzer"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/RJhSsPJyNyiKBirSl/builds/e6zAh6CaZRxEQaRee/openapi.json
