MarketPulse

# OpenClaw Market 📊

**Complete market data for autonomous agents. Powered by AIsa.**

One API key. Stocks + Crypto + Financials. Everything you need.

## 🔥 What Can You Do?

### Cross-Asset Portfolio
```
"Get BTC, ETH prices alongside AAPL, NVDA stock data for my portfolio"
```

### Investment Research
```
"Full analysis: NVDA price trends, insider trades, analyst estimates, SEC filings"
```

### Crypto Tracking
```
"Real-time prices for BTC, ETH, SOL with 30-day historical charts"
```

### Earnings Analysis
```
"Get Tesla earnings reports, analyst estimates, and price reaction"
```

### Market Screening
```
"Find stocks with P/E < 15 and revenue growth > 20%"
```

### Whale Watching
```
"Track insider trades at Apple and correlate with price movements"
```

## Quick Start

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

---

## 🏦 Traditional Finance

### Stock Prices

```bash
# Historical price data (daily)
curl "https://api.aisa.one/apis/v1/financial/prices?ticker=AAPL&interval=day&interval_multiplier=1&start_date=2025-01-01&end_date=2025-12-31" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Weekly price data
curl "https://api.aisa.one/apis/v1/financial/prices?ticker=AAPL&interval=week&interval_multiplier=1&start_date=2025-01-01&end_date=2025-12-31" \
  -H "Authorization: Bearer $AISA_API_KEY"

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

**Parameters:**
- `ticker`: Stock symbol (required)
- `interval`: `second`, `minute`, `day`, `week`, `month`, `year` (required)
- `interval_multiplier`: Multiplier for interval, e.g., 5 for 5-minute bars (required)
- `start_date`: Start date YYYY-MM-DD (required)
- `end_date`: End date YYYY-MM-DD (required)

### Company News

```bash
# Get news by ticker
curl "https://api.aisa.one/apis/v1/financial/news?ticker=AAPL&limit=10" \
  -H "Authorization: Bea...

# MarketPulse (Stocks + Crypto Data) 📊

Query real-time and historical financial data across equities and crypto—prices, market moves, metrics, and trends for analysis, alerts, and reporting.

## Features

- **Stock Data**: Historical prices, real-time quotes
- **Company News**: Latest news by ticker
- **Financial Statements**: Income, balance sheets, cash flow
- **Analyst Estimates**: EPS forecasts, recommendations
- **Insider Trading**: Track insider transactions
- **SEC Filings**: 10-K, 10-Q, 8-K and more
- **Crypto Data**: Real-time prices, historical OHLCV
- **Stock Screener**: Filter by metrics

## Quick Start

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

# Stock data
python scripts/market_client.py stock prices --ticker AAPL

# Crypto data
python scripts/market_client.py crypto snapshot --symbol BTC
```

## Documentation

See [SKILL.md](SKILL.md) for complete API documentation.