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

# Watchlist Management

> Manage ticker watchlists with targets, stops, and alert checks.

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

**Watchlists with live alert checks.** Track tickers against targets, stops, and signal changes using 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-watchlist
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Watchlist tracking" icon="list-check">
    Maintain symbols, thesis notes, and follow-up actions.
  </Card>

  <Card title="Target checks" icon="bullseye">
    Check whether prices reached target levels.
  </Card>

  <Card title="Stop monitoring" icon="shield-alert">
    Flag downside levels that need attention.
  </Card>

  <Card title="Alert summaries" icon="bell">
    Summarize watchlist changes for review.
  </Card>
</CardGroup>

## Usage

```bash theme={null}
# Add a ticker with price target and stop-loss
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-watchlist/scripts/watchlist.py" add AAPL --target 220 --stop 160

# Add with signal-change alert
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-watchlist/scripts/watchlist.py" add AAPL --alert-on signal

# List all watchlist items
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-watchlist/scripts/watchlist.py" list

# Check live prices and trigger alerts
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-watchlist/scripts/watchlist.py" check

# Check with notification
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-watchlist/scripts/watchlist.py" check --notify

# Remove a ticker
python3 "${CLAUDE_PLUGIN_ROOT}/skills/stock-watchlist/scripts/watchlist.py" remove AAPL
```

### Actions

| Action          | Description                                                        |
| --------------- | ------------------------------------------------------------------ |
| `add TICKER`    | Add ticker with optional `--target`, `--stop`, `--alert-on signal` |
| `remove TICKER` | Remove ticker from watchlist                                       |
| `list`          | Show all watchlist items                                           |
| `check`         | Fetch live prices and check alerts                                 |

## Data Storage

Watchlist data is stored in `${CLAUDE_PLUGIN_DATA}/watchlist.json` for persistence across sessions.

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

## Related

<CardGroup cols={3}>
  <Card title="Stock & Crypto Analysis" icon="file-chart-line" href="/agent-skills/stock-analysis">
    Analyze assets before adding them.
  </Card>

  <Card title="Portfolio Management" icon="wallet" href="/agent-skills/stock-portfolio">
    Review holdings and allocation.
  </Card>

  <Card title="Hot Scanner" icon="fire" href="/agent-skills/stock-hot">
    Find new watchlist candidates.
  </Card>
</CardGroup>