> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AIsa Market

> Query stock, crypto, filings, analyst, insider, and macro market data.

[View on GitHub ->](https://github.com/AIsa-team/agent-skills/tree/main/market)

**Market data for agent workflows.** Query equities, crypto, filings, analyst data, insider activity, and macro context through AIsa.

## Install

First, install the AIsa CLI if you have not already:

```bash theme={null}
npm install -g @aisa-one/cli
```

Then install the skill:

```bash theme={null}
aisa skills install market
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Stock research" icon="chart-line">
    Pull prices, news, fundamentals, and analyst context.
  </Card>

  <Card title="Crypto context" icon="coins">
    Retrieve token prices, charts, categories, and market movement.
  </Card>

  <Card title="Financial statements" icon="file-invoice-dollar">
    Analyze income, balance sheet, and cash-flow data.
  </Card>

  <Card title="Macro overlays" icon="landmark">
    Add interest-rate and market backdrop to research.
  </Card>
</CardGroup>

## 🔥 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 theme={null}
export AISA_API_KEY="your-key"
```

***

## 🏦 Traditional Finance

### Stock Prices

```bash theme={null}
# 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 theme={null}
# Get news by ticker
curl "https://api.aisa.one/apis/v1/financial/news?ticker=AAPL&limit=10" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### Financial Statements

```bash theme={null}
# All financial statements
curl "https://api.aisa.one/apis/v1/financial/financial_statements/all?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Income statements
curl "https://api.aisa.one/apis/v1/financial/financial_statements/income?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Balance sheets
curl "https://api.aisa.one/apis/v1/financial/financial_statements/balance?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Cash flow statements
curl "https://api.aisa.one/apis/v1/financial/financial_statements/cash?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### Financial Metrics

```bash theme={null}
# Real-time financial metrics snapshot
curl "https://api.aisa.one/apis/v1/financial/financial-metrics/snapshot?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Historical financial metrics
curl "https://api.aisa.one/apis/v1/financial/financial-metrics?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### Analyst Estimates

```bash theme={null}
# Earnings per share estimates
curl "https://api.aisa.one/apis/v1/financial/analyst/eps?ticker=AAPL&period=annual" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### Insider Trading

```bash theme={null}
# Get insider trades
curl "https://api.aisa.one/apis/v1/financial/insider/trades?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### Institutional Ownership

```bash theme={null}
# Get institutional ownership
curl "https://api.aisa.one/apis/v1/financial/institutional/ownership?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### SEC Filings

```bash theme={null}
# Get SEC filings
curl "https://api.aisa.one/apis/v1/financial/sec/filings?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get SEC filing items
curl "https://api.aisa.one/apis/v1/financial/sec/items?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### Company Facts

```bash theme={null}
# Get company facts by CIK
curl "https://api.aisa.one/apis/v1/financial/company/facts?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### Stock Screener

```bash theme={null}
# Screen for stocks matching criteria
curl -X POST "https://api.aisa.one/apis/v1/financial/search/stock" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":{"pe_ratio":{"max":15},"revenue_growth":{"min":0.2}}}'
```

### Interest Rates

```bash theme={null}
# Current interest rates
curl "https://api.aisa.one/apis/v1/financial/interest_rates/snapshot" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Historical interest rates
curl "https://api.aisa.one/apis/v1/financial/interest_rates/historical?bank=fed" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

***

## ₿ Cryptocurrency

### Real-Time Price Snapshot

```bash theme={null}
# Get current BTC price (use ticker format: SYMBOL-USD)
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=BTC-USD" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get current ETH price
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=ETH-USD" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get current SOL price
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=SOL-USD" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get TRUMP token price
curl "https://api.aisa.one/apis/v1/financial/crypto/prices/snapshot?ticker=TRUMP-USD" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

**Note:** Crypto tickers use format `SYMBOL-USD` (e.g., `BTC-USD`, `ETH-USD`).

### Historical Price Data

```bash theme={null}
# Get BTC historical prices (daily)
curl "https://api.aisa.one/apis/v1/financial/crypto/prices?ticker=BTC-USD&interval=day&interval_multiplier=1&start_date=2025-01-01&end_date=2025-01-31" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get ETH hourly data
curl "https://api.aisa.one/apis/v1/financial/crypto/prices?ticker=ETH-USD&interval=minute&interval_multiplier=60&start_date=2025-01-15&end_date=2025-01-16" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### Supported Cryptocurrencies

| Ticker    | Name          |
| --------- | ------------- |
| BTC-USD   | Bitcoin       |
| ETH-USD   | Ethereum      |
| SOL-USD   | Solana        |
| BNB-USD   | Binance Coin  |
| XRP-USD   | Ripple        |
| DOGE-USD  | Dogecoin      |
| ADA-USD   | Cardano       |
| AVAX-USD  | Avalanche     |
| DOT-USD   | Polkadot      |
| MATIC-USD | Polygon       |
| LINK-USD  | Chainlink     |
| UNI-USD   | Uniswap       |
| ATOM-USD  | Cosmos        |
| LTC-USD   | Litecoin      |
| TRUMP-USD | Trump Token   |
| ...       | And many more |

***

## Python Client

```bash theme={null}
# ==================== Stock Data ====================
# Note: start_date and end_date are REQUIRED for prices
python3 scripts/market_client.py stock prices --ticker AAPL --start 2025-01-01 --end 2025-01-31
python3 scripts/market_client.py stock prices --ticker AAPL --start 2025-01-01 --end 2025-01-31 --interval week
python3 scripts/market_client.py stock news --ticker AAPL --count 10

# ==================== Financial Statements ====================
python3 scripts/market_client.py stock statements --ticker AAPL --type all
python3 scripts/market_client.py stock statements --ticker AAPL --type income
python3 scripts/market_client.py stock statements --ticker AAPL --type balance
python3 scripts/market_client.py stock statements --ticker AAPL --type cash

# ==================== Metrics & Analysis ====================
python3 scripts/market_client.py stock metrics --ticker AAPL
python3 scripts/market_client.py stock analyst --ticker AAPL

# ==================== Insider & Institutional ====================
python3 scripts/market_client.py stock insider --ticker AAPL
python3 scripts/market_client.py stock ownership --ticker AAPL

# ==================== SEC Filings ====================
python3 scripts/market_client.py stock filings --ticker AAPL

# ==================== Stock Screener ====================
python3 scripts/market_client.py stock screen --pe-max 15 --growth-min 0.2

# ==================== Interest Rates ====================
python3 scripts/market_client.py stock rates
python3 scripts/market_client.py stock rates --historical

# ==================== Crypto Data ====================
# Note: Use ticker format SYMBOL-USD (or just SYMBOL, auto-converted)
python3 scripts/market_client.py crypto snapshot --ticker BTC-USD
python3 scripts/market_client.py crypto snapshot --ticker ETH  # Auto-converts to ETH-USD
python3 scripts/market_client.py crypto historical --ticker BTC-USD --start 2025-01-01 --end 2025-01-31
python3 scripts/market_client.py crypto portfolio --tickers BTC-USD,ETH-USD,SOL-USD
```

***

## API Endpoints Reference

### Traditional Finance

| Endpoint                                  | Method | Description                                        |
| ----------------------------------------- | ------ | -------------------------------------------------- |
| `/financial/prices`                       | GET    | Historical stock prices (requires interval params) |
| `/financial/news`                         | GET    | Company news by ticker                             |
| `/financial/financial_statements/all`     | GET    | All financial statements                           |
| `/financial/financial_statements/income`  | GET    | Income statements                                  |
| `/financial/financial_statements/balance` | GET    | Balance sheets                                     |
| `/financial/financial_statements/cash`    | GET    | Cash flow statements                               |
| `/financial/financial-metrics/snapshot`   | GET    | Real-time financial metrics                        |
| `/financial/financial-metrics`            | GET    | Historical metrics                                 |
| `/financial/analyst/eps`                  | GET    | EPS estimates                                      |
| `/financial/insider/trades`               | GET    | Insider trades                                     |
| `/financial/institutional/ownership`      | GET    | Institutional ownership                            |
| `/financial/sec/filings`                  | GET    | SEC filings                                        |
| `/financial/sec/items`                    | GET    | SEC filing items                                   |
| `/financial/company/facts`                | GET    | Company facts                                      |
| `/financial/search/stock`                 | POST   | Stock screener                                     |
| `/financial/interest_rates/snapshot`      | GET    | Current interest rates                             |
| `/financial/interest_rates/historical`    | GET    | Historical rates                                   |

### Cryptocurrency

| Endpoint                            | Method | Description              |
| ----------------------------------- | ------ | ------------------------ |
| `/financial/crypto/prices/snapshot` | GET    | Real-time price snapshot |
| `/financial/crypto/prices`          | GET    | Historical OHLCV data    |

***

## Pricing

| API                  | Cost       |
| -------------------- | ---------- |
| Stock prices         | \~\$0.001  |
| Company news         | \~\$0.001  |
| Financial statements | \~\$0.002  |
| Analyst estimates    | \~\$0.002  |
| SEC filings          | \~\$0.001  |
| Crypto snapshot      | \~\$0.0005 |
| Crypto historical    | \~\$0.001  |

Every response includes `usage.cost` and `usage.credits_remaining`.

***

## Get Started

1. Sign up at [aisa.one](https://aisa.one)
2. Get your API key
3. Add credits (pay-as-you-go)
4. Set environment variable: `export AISA_API_KEY="your-key"`

## Full API Reference

See [API Reference](https://aisa.one/docs/api-reference) for complete endpoint documentation.

## Get started

1. Sign up at [aisa.one](https://aisa.one) (new accounts start with \$2 free credit).
2. Generate an API key from the console.
3. Set your key and install the skill:
   ```bash theme={null}
   export AISA_API_KEY="your-key"
   npm install -g @aisa-one/cli
   aisa skills install market
   ```
4. Start a new agent session so the runtime loads the updated skill instructions.

## Related

<CardGroup cols={3}>
  <Card title="MarketPulse" icon="chart-line" href="/agent-skills/marketpulse">
    Deep equity market data and financial statements.
  </Card>

  <Card title="Crypto Market Data" icon="coins" href="/agent-skills/crypto-market-data">
    CoinGecko-powered crypto data.
  </Card>

  <Card title="Financial API reference" icon="code" href="/api-reference/financial/get_analyst-estimates">
    Explore financial endpoints.
  </Card>
</CardGroup>