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

# Hot Scanner

> Find high-momentum stocks, crypto movers, and market catalysts.

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

**Hot market scans for agents.** Find trending stocks and crypto movers with live AIsa market data.

## 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-hot
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Momentum scans" icon="fire">
    Surface stocks and crypto assets with unusual movement.
  </Card>

  <Card title="Catalyst lookup" icon="newspaper">
    Connect price movement to recent news or events.
  </Card>

  <Card title="Market movers" icon="arrow-trend-up">
    Summarize top gainers, losers, and volume spikes.
  </Card>

  <Card title="Watchlist ideas" icon="list-plus">
    Turn scans into candidates for follow-up alerts.
  </Card>
</CardGroup>

## Usage

```bash theme={null}
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-hot/scripts/hot_scanner.py"
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-hot/scripts/hot_scanner.py" --focus stocks
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-hot/scripts/hot_scanner.py" --focus crypto
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-hot/scripts/hot_scanner.py" --output json
```

### Arguments

* `--focus`: Filter by `stocks`, `crypto`, or `both` (default)
* `--output json`: Append structured JSON summary

## Output Sections

* **Top Stock Movers**: Gainers (>3%), losers, most active by volume
* **Crypto Highlights**: BTC price, dominance, trending coins, gainers/losers
* **News-Driven Movers**: 5-8 items with ticker mentions from last 6 hours
* **Top 5 Watchlist Picks**: With risk level assessment
* **Quick Take**: 2-3 sentence market summary

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

## Related

<CardGroup cols={3}>
  <Card title="Watchlist Management" icon="list-check" href="/agent-skills/stock-watchlist">
    Track candidates after a scan.
  </Card>

  <Card title="Rumor Scanner" icon="radio" href="/agent-skills/stock-rumors">
    Scan early market signals and rumors.
  </Card>

  <Card title="AIsa Market" icon="chart-line" href="/agent-skills/market">
    Retrieve supporting market data.
  </Card>
</CardGroup>