> ## 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.

# Stock & Crypto Analysis

> Analyze stock and crypto tickers with live market context.

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

**Stock and crypto analysis with live data.** Analyze tickers, risk signals, targets, and market 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 stock-analysis
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Analysis reports" icon="file-chart-line">
    Create structured stock or crypto analysis reports.
  </Card>

  <Card title="Risk flags" icon="triangle-exclamation">
    Surface volatility, liquidity, and catalyst risks.
  </Card>

  <Card title="Levels and targets" icon="bullseye">
    Suggest watch levels, targets, and stops for review.
  </Card>

  <Card title="Scoring" icon="gauge-high">
    Compare opportunities with a repeatable scoring rubric.
  </Card>
</CardGroup>

## Setup

This skill requires an AIsa API key. Set it via plugin configuration or environment variable:

```bash theme={null}
export AISA_API_KEY=your_key_here
export AISA_BASE_URL=https://api.aisa.one/v1   # optional
export AISA_MODEL=gpt-4o                         # optional
```

Or use the plugin's `userConfig` values (set automatically when the plugin is enabled).

## Usage

Run the analysis script with one or more ticker symbols:

```bash theme={null}
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-analysis/scripts/analyze_stock.py" AAPL
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-analysis/scripts/analyze_stock.py" BTC-USD ETH-USD
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-analysis/scripts/analyze_stock.py" AAPL MSFT GOOGL
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-analysis/scripts/analyze_stock.py" AAPL --fast
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-analysis/scripts/analyze_stock.py" AAPL --output json
```

### Arguments

* **Tickers**: One or more stock symbols (e.g., `AAPL`, `MSFT`) or crypto symbols (e.g., `BTC-USD`, `ETH-USD`)
* `--fast`: Skip slow analyses (insider trading, detailed news) for faster results
* `--output json`: Append a structured JSON summary after the analysis

### Multi-Ticker Comparison

When multiple tickers are provided, the script produces individual analyses followed by a ranked comparison table:

| Ticker | Score | Signal | Key Strength | Key Risk |
| ------ | ----- | ------ | ------------ | -------- |

## 8-Dimension Scoring (Stocks)

| # | Dimension                                | Weight |
| - | ---------------------------------------- | ------ |
| 1 | Earnings Surprise                        | 30%    |
| 2 | Fundamentals (P/E, margins, growth)      | 20%    |
| 3 | Analyst Sentiment                        | 20%    |
| 4 | Historical Patterns                      | 10%    |
| 5 | Market Context (VIX, SPY/QQQ)            | 10%    |
| 6 | Sector Performance                       | 15%    |
| 7 | Momentum (RSI, 52w range)                | 15%    |
| 8 | Sentiment (Fear/Greed, shorts, insiders) | 10%    |

## 3-Dimension Scoring (Crypto)

| # | Dimension                     | Weight |
| - | ----------------------------- | ------ |
| 1 | Market Cap & Category         | 40%    |
| 2 | BTC Correlation (30-day)      | 30%    |
| 3 | Momentum (RSI, range, volume) | 30%    |

## Risk Flags

Automatically detected: Pre-earnings, Post-spike, Overbought, Risk-Off, Breaking News

## Output

Final recommendation includes: **Score (0-10)**, **Signal (BUY/HOLD/SELL)**, **Confidence (High/Medium/Low)**, and **Entry / Target / Stop prices**.

**NOT FINANCIAL ADVICE.** For informational purposes only.

## 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 stock-analysis
   ```
4. Start a new agent session so the runtime loads the updated skill instructions.

## Related

<CardGroup cols={3}>
  <Card title="AIsa Market" icon="chart-line" href="/agent-skills/market">
    Broad stock and crypto market data.
  </Card>

  <Card title="Watchlist Management" icon="list-check" href="/agent-skills/stock-watchlist">
    Track targets, stops, and alert checks.
  </Card>

  <Card title="US Stock Analyst" icon="file-invoice-dollar" href="/agent-skills/us-stock-analyst">
    Deeper US equity analysis reports.
  </Card>
</CardGroup>