CNN Business Stock Price Actor

Overview

This actor scrapes real-time stock price data and financial analysis from CNN Business. It fetches current prices, 52-week ranges, 200-day moving averages, and professional market analysis for a given stock ticker.

Key Features

• Real-time Data: Retrieves current stock prices with timestamps.
• Financial Metrics: Provides the 52-week high/low and the 200-day simple moving average.
• Market Analysis: Includes formatted summary, momentum analysis, and definitions from CNN.
• Flexible Output: Returns data in detailed, compact, or minimal JSON formats.
• Error Handling: Includes built-in ticker symbol validation and robust error management.

How to Use

Configure the actor run with a JSON input containing the stock ticker symbol. You can optionally adjust the data included and the output format.

Input

The actor requires a ticker parameter. All other parameters are optional.

Required Parameter:
* ticker (string): The stock symbol (1-5 characters). Example: "AAPL", "KO".

Optional Parameters:
* includeAnalysis (boolean, default: true): Includes summary, analysis, and definition sections.
* includeSummary (boolean, default: true): Includes list summary and usage info.
* outputFormat (string, default: "detailed"): Output structure. Options: "detailed", "compact", "minimal".
* waitForData (boolean, default: false): If true, only returns results when sufficient data is available from the source.

Example Input:

{
  "ticker": "KO",
  "includeAnalysis": true,
  "outputFormat": "compact"
}

Output

The output is a JSON object. Its structure varies based on the chosen outputFormat.

Common Fields (All Formats):
* ticker: The requested stock symbol.
* timestamp: The time the actor fetched the data.
* current_price / price: The stock price in USD.
* last_updated: The timestamp of the source data from CNN.

Format-Specific Fields:
* Detailed ("detailed"): The full dataset, split into priceData, metadata, and analysis objects. Includes shares outstanding, 52-week range, moving average, and formatted analysis text.
* Compact ("compact"): A streamlined object with price, range_52w (high/low), and moving_avg_200d.
* Minimal ("minimal"): Only the ticker, timestamp, current_price, and last_updated.

Example Compact Output:

{
  "ticker": "KO",
  "timestamp": "2025-08-11T11:09:06.187Z",
  "price": 70.34,
  "range_52w": {
    "low": 60.615,
    "high": 74.38
  },
  "moving_avg_200d": 67.85435,
  "last_updated": "2025-08-10T07:34:51.334991+00:00"
}