US Stock Analyst

View on GitHub -> Equity research reports for agents. Pull financials, news, filings, sentiment, and model synthesis into one US stock analysis workflow.

Install

aisa skills install us-stock-analyst

What can agents do with it?

Equity reports

Create structured analysis for US-listed stocks.

Filing context

Use SEC filings and company disclosures.

Sentiment synthesis

Add news and social signal context.

Investment memo

Summarize risks, catalysts, and watch items.

🔥 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"

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:

GPT-4, GPT-4 Turbo (OpenAI)
Claude 3 Opus, Sonnet, Haiku (Anthropic)
Gemini 1.5 Pro, Ultra (Google)
Qwen Max, Plus (Alibaba)
DeepSeek V2 (DeepSeek)
Grok (xAI)

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:

Quick: $0.01-0.02 per stock
Standard: $0.02-0.05 per stock
Deep: $0.05-0.10 per stock

Comparison:

Bloomberg Terminal: $2,000/month
FactSet: $1,000/month
Traditional Analyst Report: $50-500 each
AIsa Stock Analyst: $0.02-0.10 each ✨

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

Screen and analyze stocks before investing:

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

2. Portfolio Monitoring

Daily updates on your holdings:

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

3. Earnings Season

Comprehensive earnings analysis:

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

4. Insider Tracking

Monitor insider activity:

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

5. Sentiment Analysis

Track market perception:

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:

SEC Rule 15c2-1 (not investment advice)
FINRA regulations (informational only)
GDPR data privacy compliant

Get Started

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

Full API Documentation

API Reference: https://aisa.one/docs/api-reference
Complete Docs: https://aisa.one/docs/llms.txt
Support: support@aisa.one
Discord: https://discord.gg/aisa

About AIsa

AIsa - Unified API infrastructure for AI agents. Single API Key. Pay-Per-Use. Agent-Native.

Website: https://aisa.one
Documentation: https://aisa.one/docs

Get started

Sign up at aisa.one (new accounts start with $2 free credit).
Generate an API key from the console.

Set your key and install the skill:

export AISA_API_KEY="your-key"
aisa skills install us-stock-analyst

Start a new agent session so the runtime loads the updated skill instructions.

MarketPulse

Deep financial and filing data.

Stock & Crypto Analysis

General asset analysis workflow.

Financial API reference

Underlying financial endpoint docs.

Documentation Index

​Install

​What can agents do with it?

Equity reports

Filing context

Sentiment synthesis

Investment memo

​🔥 What Can You Do?

​Investment Research

​Portfolio Monitoring

​Earnings Analysis

​Competitor Analysis

​Screening & Discovery

​Quick Start

​Core Capabilities

​📊 Financial Data (MarketPulse APIs)

​📰 News & Research

​🐦 Social Sentiment

​📺 Video Content

​🤖 AI Analysis (Multi-Model)

​Python Client

​Analysis Depth Options

​API Reference

​Example Output

​Pricing

​Use Cases

​1. Investment Research

​2. Portfolio Monitoring

​3. Earnings Season

​4. Insider Tracking

​5. Sentiment Analysis

​Compliance

​Get Started

​Full API Documentation

​About AIsa

​Get started

​Related