storyclaw-alpaca-trading

Alpaca Trading - US Stock & Crypto Trading

Trade US stocks and crypto via Alpaca API. Supports both paper trading (simulated, free) and real trading.

Critical Rules

1. NEVER execute a trade without showing a plan and getting explicit confirmation
2. NEVER set up cron jobs without proposing them first
3. NEVER make up prices or data — always query real data
4. NEVER assume what the user wants to trade — ask first

Multi-User Support

Each user has their own credentials/{USER_ID}.json:

{
  "apiKey": "YOUR_KEY",
  "apiSecret": "YOUR_SECRET",
  "baseUrl": "https://paper-api.alpaca.markets",
  "dataUrl"

To switch to real trading, change baseUrl to https://api.alpaca.markets.

Or set ALPACA_API_KEY and ALPACA_API_SECRET env vars.

First-Time User Flow

1. Check credentials: USER_ID=$TELEGRAM_USER_ID node {baseDir}/scripts/trading.js check
2. Ask what they want to trade (stocks vs crypto, symbols, amount, risk)
3. Propose a concrete plan — WAIT FOR CONFIRMATION
4. Execute only after user confirms

Commands

Account & Positions

Market Data

Trading

Strategy

Features

• US Stocks & Crypto (AAPL, TSLA, BTC, ETH, and more)
• Paper OR real trading (depends on credentials)
• Real-time quotes (15-min delayed on free tier)
• Market orders, technical indicators (RSI)
• Market hours: Stocks 9:30-16:00 ET Mon-Fri; Crypto 24/7

Setup

1. Sign up at https://app.alpaca.markets/brokerage/new-account
2. Generate API key + secret (Paper Trading section)
3. Create credentials/{USER_ID}.json or set env vars

API Limits