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

export AISA_API_KEY="your-key"

Core Capabilities

📊 Financial Data (MarketPulse APIs)

Real-time Financial Metrics

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

# 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

# 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

# EPS forecasts and ratings
curl "https://api.aisa.one/apis/v1/financial/analyst/eps?ticker=AAPL&period=annual" \
  -H "Authorization: Bearer $AISA_API_KEY"

Insider Trading

# Track insider buy/sell activity
curl "https://api.aisa.one/apis/v1/financial/insider/trades?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

Institutional Ownership

# See who owns the stock
curl "https://api.aisa.one/apis/v1/financial/institutional/ownership?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

SEC Filings

# Access 10-K, 10-Q, 8-K filings
curl "https://api.aisa.one/apis/v1/financial/sec/filings?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

📰 News & Research

Company News

curl "https://api.aisa.one/apis/v1/financial/news?ticker=AAPL&limit=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

Web Search (News & Articles)

curl -X POST "https://api.aisa.one/apis/v1/scholar/search/web?query=AAPL+stock+analysis&max_num_results=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

Academic Research

curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar?query=semiconductor+industry+analysis&max_num_results=5" \
  -H "Authorization: Bearer $AISA_API_KEY"

🐦 Social Sentiment

Twitter Search

curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=\$AAPL&queryType=Latest" \
  -H "Authorization: Bearer $AISA_API_KEY"

📺 Video Content

YouTube Search (Earnings Calls, Analysis)

curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AAPL+earnings+call&gl=us&hl=en" \
  -H "Authorization: Bearer $AISA_API_KEY"

🤖 AI Analysis (Multi-Model)

LLM Gateway (OpenAI Compatible)

curl -X POST "https://api.aisa.one/v1/chat/completions" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [
      {
        "role": "system",
        "content": "You are a professional equity analyst."
      },
      {
        "role": "user",
        "content": "Analyze Apple stock investment prospects"
      }
    ],
    "temperature": 0.3,
    "max_tokens": 2000
  }'

Supported Models:

Python Client

# Basic analysis
python3 scripts/stock_analyst.py analyze --ticker AAPL
Standard analysis with multiple models
python3 scripts/stock_analyst.py analyze --ticker NVDA --depth standard --models gpt-4 claude-3-opus
Deep analysis (all data sources)
python3 scripts/stock_analyst.py analyze --ticker TSLA --depth deep
Quick screening
python3 scripts/stock_analyst.py analyze --ticker MSFT --depth quick
Save report to file
python3 scripts/stock_analyst.py analyze --ticker GOOGL --output report.json

Analysis Depth Options

| Mode | Time | Cost | Data Sources | |------|------|------|--------------| | quick | ~10s | $0.01-0.02 | 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 |

API Reference

| Category | Endpoint | Method | Cost | |----------|----------|--------|------| | Financial Metrics | /financial/financial-metrics/snapshot | GET | $0.002 | | Stock Prices | /financial/prices | GET | $0.001 | | News | /financial/news | GET | $0.001 | | Statements | /financial/financial_statements/* | GET | $0.002 | | Analyst Estimates | /financial/analyst/eps | GET | $0.002 | | Insider Trades | /financial/insider/trades | GET | $0.001 | | Institutional | /financial/institutional/ownership | GET | $0.001 | | SEC Filings | /financial/sec/filings | GET | $0.001 | | Web Search | /scholar/search/web | POST | $0.001 | | Scholar Search | /scholar/search/scholar | POST | $0.002 | | Twitter | /twitter/tweet/advanced_search | GET | $0.0004 | | YouTube | /youtube/search | GET | $0.002 | | LLM | /v1/chat/completions | POST | Token-based |

Every response includes usage.cost and usage.credits_remaining.

Example Output

{
  "ticker": "NVDA",
  "analysis_date": "2025-02-07T10:30:00Z",
  
  "investment_summary": "NVIDIA maintains dominant position in AI chip market with strong data center revenue growth. Recent Blackwell launch positions company for continued expansion...",
  
  "key_metrics": {
    "market_cap": 1780500000000,
    "pe_ratio": 68.5,
    "revenue": 60922000000,
    "revenue_growth": 1.26,
    "profit_margin": 0.489,
    "roe": 1.152
  },
  
  "sentiment_analysis": {
    "sentiment": "bullish",
    "confidence": "high",
    "key_themes": ["AI dominance", "Data center growth", "Blackwell launch"],
    "summary": "Overwhelmingly positive sentiment following Q4 earnings beat"
  },
  
  "valuation": {
    "assessment": "fairly_valued",
    "price_target_12m": 850.00,
    "reasoning": "Premium valuation justified by AI market leadership and strong growth trajectory"
  },
  
  "data_sources": {
    "Financial Metrics": "Available",
    "Stock News": 10,
    "Analyst Estimates": "Available",
    "Insider Trades": 15,
    "Twitter": "Available",
    "YouTube": 5
  }
}

Pricing

Analysis Costs:

Comparison:

Cost Breakdown:

Standard Analysis ($0.02-0.05):
├── Financial Metrics: $0.002
├── Stock Prices: $0.001
├── Company News: $0.001
├── Analyst Estimates: $0.002
├── Insider Trades: $0.001
├── Twitter: $0.0004
├── YouTube: $0.002
└── LLM Analysis: $0.01-0.04

Use Cases

1. Investment Research

analyst.analyze_stock("NVDA", depth="deep")

2. Portfolio Monitoring

for ticker in ["AAPL", "MSFT", "GOOGL"]:
    report = analyst.analyze_stock(ticker, depth="quick")

3. Earnings Season

analyst.analyze_stock("TSLA", depth="standard")
Check estimates, actual results, guidance, reaction

4. Insider Tracking

report = analyst.analyze_stock("META", depth="standard")
print(report['raw_data']['insider_trades'])

5. Sentiment Analysis

report = analyst.analyze_stock("COIN", depth="standard")
print(report['sentiment_analysis'])

Compliance

Disclaimer (Always Included): > This analysis is for informational purposes only and should not be > considered personalized investment advice. Please conduct your own > research and consult with licensed financial advisors before making > investment decisions.

Regulatory Compliance:

Get Started

1. Sign up at aisa.one 2. Get your API key 3. Add credits (pay-as-you-go, minimum $5) 4. Set environment variable: export AISA_API_KEY="your-key" 5. Run analysis: python scripts/stock_analyst.py analyze --ticker AAPL

Full API Documentation

About AIsa

AIsa - Unified API infrastructure for AI agents.

Single API Key. Pay-Per-Use. Agent-Native.

export AISA_API_KEY="your-key"