# Market Intelligence Suite

The Market Intelligence Suite provides real-time financial market news and movement alerts through two specialized AI agents:

1. **Market News Agent**: Delivers the latest financial market news and analysis
2. **Market Alerts Agent**: Monitors significant market movements and provides real-time alerts

## Features

### Market News Agent

- Retrieves and analyzes the latest financial market news from multiple sources
- Focuses on forex, stocks, commodities, and economic news
- Provides context and analysis for market-moving events
- Organizes news by market segment and highlights important developments
- Supports specific currency pair queries (e.g., "What's the latest news affecting EUR/USD?")

### Market Alerts Agent

- Monitors significant price movements across major currency pairs
- Detects various types of market events:
  - **Price Changes**: Significant percentage movements
  - **Volatility Changes**: Unusual increases in market volatility
  - **Key Level Approaches**: When price approaches important support/resistance levels
  - **Breakouts**: When price breaks out of established trading ranges
- Provides real-time notifications for these events
- Allows querying for recent market movements

## Usage

### Accessing the Suite

1. Launch the application
2. Select the "Market Intelligence Suite" tab
3. The interface is divided into two sections - Market News and Market Alerts

### Getting Market News

1. Enter your query in the text area under "Market News"
   - Examples:
     - "What are the latest news affecting EUR/USD?"
     - "Summarize today's economic news and market impact"
     - "Analyze recent Federal Reserve statements and their effect on USD"
2. Click "Get Market News"
3. View the AI-generated response with the latest relevant information
4. Previous queries and responses are saved in the "Recent News Queries" section

### Using Market Alerts

1. Enter your query in the text area under "Market Alerts"
   - Examples:
     - "Show me recent EUR/USD price breakouts"
     - "What significant market movements have happened today?"
     - "Has there been unusual volatility in USD/JPY in the past 24 hours?"
2. Click "Check Market Alerts"
3. View the AI-generated analysis of recent market movements
4. Previous queries and responses are saved in the "Recent Alerts Queries" section

### Alert Monitoring

The Market Alerts agent continuously monitors currency pairs for significant movements. You can:

- Check the monitoring status in the "Alert Monitoring Status" section
- Start or stop monitoring using the provided buttons
- See statistics about monitored currency pairs and collected alerts

## Technical Details

### Data Sources

The Market News Agent integrates with multiple financial news sources:
- Alpha Vantage (requires API key)
- Financial Modeling Prep (requires API key)
- Marketaux (requires API key)

### Market Movement Detection

The Market Alerts Agent monitors for these market events:
- Price changes exceeding 0.5% between periods
- Volatility increases of 50% or more
- Prices approaching key levels within 10 pips
- Breakouts from established trading ranges

### API Keys

To enable full functionality, the following API keys should be set in your environment:
- `ALPHA_VANTAGE_API_KEY`: For Alpha Vantage financial news
- `FMP_API_KEY`: For Financial Modeling Prep news
- `MARKETAUX_API_KEY`: For Marketaux financial news

## Dependencies

The Market Intelligence Suite uses the Agno framework for its agents, with:
- OpenAI API for LLM capabilities (requires `OPENAI_API_KEY`)
- DuckDuckGo search for real-time information retrieval
- Pandas for data manipulation
- Threading for background monitoring processes