us-stock-analyst

# US Stock Analyst 📈

**Professional equity analysis powered by AIsa's unified API platform.**

One API key. Complete market intelligence. AI-powered insights.

## 🔥 What Can You Do?

### Investment Research
```
"Analyze NVDA: financial metrics, analyst estimates, insider trades, 
news sentiment, and AI-powered valuation"
```

### Portfolio Monitoring
```
"Track my portfolio (AAPL, MSFT, GOOGL): daily updates on metrics, 
news, and sentiment changes"
```

### Earnings Analysis
```
"Full Tesla Q4 earnings analysis: results vs estimates, guidance, 
price reaction, analyst updates"
```

### Competitor Analysis
```
"Compare AMD vs NVDA: financials, growth, valuation, market sentiment"
```

### Screening & Discovery
```
"Find tech stocks with P/E < 30, revenue growth > 20%, 
and positive insider activity"
```

## Quick Start

```bash
export AISA_API_KEY="your-key"
```

---

## Core Capabilities

### 📊 Financial Data (MarketPulse APIs)

**Real-time Financial Metrics**
```bash
curl "https://api.aisa.one/apis/v1/financial/financial-metrics/snapshot?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

Returns: Market cap, P/E ratio, revenue, EPS, profit margin, ROE, debt/equity, and more.

**Historical Stock Prices**
```bash
# Daily prices for last 30 days
curl "https://api.aisa.one/apis/v1/financial/prices?ticker=AAPL&start_date=2025-01-01&end_date=2025-01-31&interval=day&interval_multiplier=1" \
  -H "Authorization: Bearer $AISA_API_KEY"

# 5-minute intraday data
curl "https://api.aisa.one/apis/v1/financial/prices?ticker=AAPL&start_date=2025-02-07&end_date=2025-02-07&interval=minute&interval_multiplier=5" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

**Financial Statements**
```bash
# All statements (income, balance, cash flow)
curl "https://api.aisa.one/apis/v1/financial/financial_statements/all?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

**Analyst Estimates**
```bash
# EPS forecasts and ratings
curl "https://api.aisa.one/apis/v1/financ...

# US Stock Analyst - OpenClaw Skill

Professional equity analysis powered by AIsa's unified API platform.

## Features

- **Complete Financial Data**: Metrics, prices, statements, estimates, insider trades, SEC filings
- **Multi-Source Intelligence**: News, web search, academic research, social media, video content
- **AI-Powered Analysis**: Multi-model synthesis with GPT-4, Claude, Gemini, and more
- **Flexible Depth**: Quick, standard, or deep analysis modes
- **Affordable**: $0.02-0.10 per analysis (vs $2,000/month for Bloomberg)

## Quick Start

```bash
# Set your AIsa API key
export AISA_API_KEY="your-key"

# Run basic analysis
python scripts/stock_analyst.py analyze --ticker AAPL

# Run deep analysis with custom models
python scripts/stock_analyst.py analyze --ticker NVDA --depth deep --models gpt-4 claude-3-opus
```

## Installation

```bash
# Install dependencies
pip install httpx asyncio

# Or use requirements.txt
pip install -r requirements.txt
```

## Analysis Modes

| Mode | Time | Cost | Data Sources |
|------|------|------|--------------|
| **quick** | ~10s | $0.01-0.02 | Financial metrics, news, Twitter, basic AI |
| **standard** | ~20s | $0.02-0.05 | + Analyst estimates, insider trades, YouTube |
| **deep** | ~30s | $0.05-0.10 | + Statements, institutional, SEC, research |

## Examples

### Basic Analysis

```python
from scripts.stock_analyst import AIsaStockAnalyst
import asyncio

async def main():
    analyst = AIsaStockAnalyst(api_key="your_key")
    
    report = await analyst.analyze_stock(
        ticker="AAPL",
        depth="standard"
    )
    
    print(report['investment_summary'])
    print(f"Sentiment: {report['sentiment_analysis']['sentiment']}")
    
    await analyst.close()

asyncio.run(main())
```

### Portfolio Monitoring

```python
async def monitor_portfolio():
    analyst = AIsaStockAnalyst(api_key="your_key")
    
    portfolio = ["AAPL", "MSFT", "GOOGL", "NVDA", "TSLA"]
    
    for ticker in portfolio:
        report = await...