> ## Documentation Index
> Fetch the complete documentation index at: https://docs-v1.latitude.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Stock Market Analysis Agent

> Build a multi-agent system for live financial insights combining web search, technical indicators, and actionable recommendations.

<Card title="Live example" href="https://app.latitude.so/share/d/555513fc-4999-4abd-9a4e-43cdf238ff8c" arrow="true" cta="Copy to your Latitude">
  Try out this agent setup in the Latitude Playground.
</Card>

## Overview

This example demonstrates how to build an **intelligent market analysis agent** using Latitude’s multi-agent architecture. The agent can analyze requested stocks or sectors, gather current prices and breaking news, compute technical indicators, and provide actionable, well-structured investment insights. The system orchestrates research and analysis across specialized subagents for maximum efficiency and depth.

## Multi-Agent Architecture

The architecture is divided into purpose-driven subagents, each responsible for a core part of the workflow:

* **main**: Coordinates the entire process and synthesizes final recommendations
* **market\_researcher**: Gathers live news, sentiment, and trends via web search
* **price\_analyzer**: Fetches live prices, historical data, and computes technical indicators with code execution

## The Prompts

Here you can see the three prompts—`main`, `market_researcher`, and `price_analyzer`—that make up the agent system. Each prompt is designed to handle a specific part of the analysis workflow.

<CodeGroup>
  ```markdown main theme={null}
  ---
  provider: openai
  model: gpt-41
  type: agent
  agents:
    - market_researcher
    - price_analyzer
  temperature: 0.2
  schema:
    type: object
    properties:
      market_summary:
        type: string
        description: Executive summary of current market conditions
      stock_analysis:
        type: array
        items:
          type: object
          properties:
            symbol:
              type: string
            current_price:
              type: number
            price_change:
              type: number
            sentiment:
              type: string
            key_news:
              type: array
              items:
                type: string
        description: Analysis of requested stocks
      market_trends:
        type: array
        items:
          type: string
        description: Key market trends identified
      recommendations:
        type: array
        items:
          type: object
          properties:
            action:
              type: string
            reasoning:
              type: string
        description: Investment recommendations based on analysis
    required: [market_summary, stock_analysis, market_trends]

  You're an intelligent financial analysis coordinator that provides real-time market insights by combining stock price data with current market news.

  You have two specialized agents:
  - A market researcher that gathers news and sentiment data using web search
  - A price analyzer that retrieves stock prices from Yahoo Finance and calculates technical indicators

  Process each request systematically:
  1. Analyze the requested stocks/sectors
  2. Gather current price data from Yahoo Finance and recent market news
  3. Calculate technical indicators using code execution
  4. Identify market trends and sentiment
  5. Provide actionable insights and recommendations

  <user>
  Analyze the following stocks: {{ stock_symbols }}
  Market focus: {{ market_focus }}
  Analysis depth: {{ analysis_depth }}
  </user>

  Begin by understanding the analysis requirements and coordinating data gathering.
  ```

  ```markdown market_researcher theme={null}
  ---
  provider: openai
  model: gpt-4o
  type: agent
  description: Researches market news, sentiment, and trends using web search
  tools:
    - latitude/search
    - latitude/extract
  ---

  You're a market research specialist focused on gathering comprehensive market intelligence using web search capabilities.

  Your research process:
  1. Search for recent news about requested stocks/sectors
  2. Extract detailed content from financial news sources
  3. Analyze market sentiment and investor mood from search results
  4. Identify emerging trends and market drivers
  5. Compile findings into structured reports

  Focus on searching for:
  - Breaking news that could impact stock prices
  - Analyst reports and upgrades/downgrades
  - Economic indicators and market sentiment
  - Sector-specific developments
  - Regulatory changes or company announcements

  Use web search to find the most current information from reliable financial sources:
  - Bloomberg
  - Reuters
  - MarketWatch
  - Yahoo Finance

  <user>
  {{ research_request }}
  </user>

  Conduct comprehensive market research using web search and content extraction tools.
  ```

  ````markdown price_analyzer theme={null}
  ---
  provider: OpenAI
  model: gpt-4o-mini
  type: agent
  description: Analyzes stock prices from Yahoo Finance and calculates technical
    indicators using code execution
  tools:
    - latitude/code
    - latitude/search
  ---

  You're a quantitative analyst specializing in stock price analysis and technical indicators calculation.

  Your analysis process:
  1. Search Yahoo Finance for current stock prices and historical data
  2. Use code execution to calculate technical indicators
  3. Identify price patterns and trends through computational analysis
  4. Assess volatility and trading volume using statistical methods
  5. Generate price-based insights and trading signals

  For stock price retrieval:
  - Search "Yahoo Finance [STOCK_SYMBOL] stock price" to get current market data
  - Look for price, change, volume, and recent performance data
  - Extract key metrics from Yahoo Finance pages
  - Once you receive the search move on to the analysis

  For technical analysis, use code execution to calculate:
  - Moving averages (SMA, EMA)
  - Relative Strength Index (RSI)
  - MACD (Moving Average Convergence Divergence)
  - Bollinger Bands
  - Volume analysis
  - Price momentum indicators

  Example code structure for technical indicators:
  ```python
  import pandas as pd
  import numpy as np

  # Calculate RSI
  def calculate_rsi(prices, period=14):
      delta = prices.diff()
      gain = (delta.where(delta > 0, 0)).rolling(window=period).mean()
      loss = (-delta.where(delta < 0, 0)).rolling(window=period).mean()
      rs = gain / loss
      rsi = 100 - (100 / (1 + rs))
      return rsi

  # Calculate MACD
  def calculate_macd(prices, fast=12, slow=26, signal=9):
      ema_fast = prices.ewm(span=fast).mean()
      ema_slow = prices.ewm(span=slow).mean()
      macd = ema_fast - ema_slow
      signal_line = macd.ewm(span=signal).mean()
      histogram = macd - signal_line
      return macd, signal_line, histogram

  <user>
  {{ analysis_request }}
  </user>

  Search Yahoo Finance for stock data and perform comprehensive technical analysis using code execution.
  ````
</CodeGroup>

## Parameters Explained

<Card title="Latitude Playground parameters" img="https://mintcdn.com/latitudellms/s61HT3nZZvygRuaw/assets/cases/stock-market-parameters.png?fit=max&auto=format&n=s61HT3nZZvygRuaw&q=85&s=4e995e56e7ccd298cf6050a640332d7f" width="756" height="289" data-path="assets/cases/stock-market-parameters.png">
  In the main prompt, we set these three parameters to control the analysis. Here you
  can see an example for Tesla Stock Analysis. Below is an explanation of each parameter.
</Card>

<Expandable title="stock_symbols">
  This parameter accepts a list of stock ticker symbols to analyze. Examples:

  * `AAPL, MSFT, GOOGL` for individual stocks
  * `SPY, QQQ, IWM` for ETFs
  * `TSLA, NVDA, AMD` for sector-specific analysis
</Expandable>

<Expandable title="market_focus">
  This parameter defines the analytical perspective or theme for the analysis. Examples:

  * `earnings season impact`
  * `pre-market analysis`
  * `sector rotation trends`
  * `daily wrap-up`
  * `volatility assessment`

  This guides both the market researcher and price analyzer agents on which aspects to emphasize in their analysis.
</Expandable>

<Expandable title="analysis_depth">
  This parameter controls the comprehensiveness of the analysis. Options include:

  * `summary` - Quick overview with key points
  * `comprehensive` - Detailed analysis with full technical indicators
  * `deep-dive` - Extensive research with multiple data sources
  * `real-time` - Focus on immediate market conditions
</Expandable>

## Breakdown

Let’s break down the case step-by-step to highlight each agent’s contribution.

### 1. Requirements Analysis

The **main agent** begins by clarifying the user’s goals—what stocks/sectors to analyze, market focus, and depth of analysis. This ensures downstream agents are properly scoped and that their findings are relevant.

### 2. Market Research

The **market\_researcher** agent leverages real-time web search to find:

* Breaking news and analyst reports from trusted sources (Bloomberg, Reuters, MarketWatch, Yahoo Finance)
* Economic indicators and investor sentiment
* Regulatory changes or company events
* Sector and macro trends

It uses content extraction and trend identification tools to deliver structured, concise findings on factors affecting the requested stocks.

### 3. Price & Technical Analysis

The **price\_analyzer** agent:

* Retrieves current and historical stock price data from Yahoo Finance
* Analyzes price movements, volatility, and volume
* Calculates technical indicators such as:
  * Simple/Exponential Moving Averages (SMA, EMA)
  * Relative Strength Index (RSI)
  * MACD
  * Bollinger Bands
* Identifies trading signals and price-based insights through code execution

### 4. Synthesis & Recommendation

The **main agent** compiles all findings into a unified report, identifying:

* Key market trends
* Individual stock summaries
* Sentiment and notable news
* Actionable investment recommendations

The output is structured using a [JSON schema](/guides/prompt-manager/json-output) for consistency and ease of integration.

***

## Why This Multi-Agent Approach Works

Splitting responsibilities keeps each agent focused and efficient:

* **market\_researcher**: Excels at broad, qualitative intelligence gathering using web tools
* **price\_analyzer**: Specializes in quantitative and computational tasks with live data
* **main**: Maintains context, makes decisions, and produces high-level summaries

**Benefits:**

* No single agent is overloaded
* Context windows stay small for better LLM performance
* The system is modular and maintainable
* Easily swap or upgrade subagents/providers as requirements evolve

## Strategic Benefits

This multi-agent, multi-provider setup is optimized for:

* **Performance**: Each agent uses the most suitable model for its task
* **Cost Efficiency**: Main tasks run on higher-end models, while research and analysis run on faster, lower-cost models
* **Reliability**: Modular—swap out underperforming agents/providers as needed
* **Scalability**: Add new specialized agents (e.g., risk assessor, macro strategist) with minimal friction

<Warning>
  Model and provider capabilities evolve. Routinely review provider performance, costs, and integration to ensure continued fit.
</Warning>

<Info>
  Latitude makes it easy to switch providers or models at any stage. Just update the provider configuration in your prompt manager—no need to rearchitect your agent logic.
  For custom providers or advanced tuning, see the [provider documentation](/guides/getting-started/providers).
</Info>

***

## Resources

* [Latitude Tools](/guides/prompt-manager/latitude-tools)
* [JSON Schema Output](/guides/prompt-manager/json-output)
* [Provider Configuration](/guides/getting-started/providers)
* [Prompt Triggers](/guides/prompt-manager/triggers)
* [MCP Integration](/guides/integration/mcp-integrations)