storyclaw-alpaca-trading

Original：🇺🇸 English

Translated

4 scripts

US stock and crypto trading via Alpaca API. Paper trading (simulated) and real trading supported. Real-time quotes, orders, positions, RSI strategy.

4installs

Sourcestoryclaw-official/talenthub

Added on2026-03-24

NPX Install

npx skill4agent add storyclaw-official/talenthub storyclaw-alpaca-trading

SKILL.md Content

View Translation Comparison →

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

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

Multi-User Support

Each user has their own

credentials/{USER_ID}.json

:

json

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

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

Check credentials:

USER_ID=$TELEGRAM_USER_ID node {baseDir}/scripts/trading.js check

Ask what they want to trade (stocks vs crypto, symbols, amount, risk)
Propose a concrete plan — WAIT FOR CONFIRMATION
Execute only after user confirms

Commands

Account & Positions

bash

node {baseDir}/scripts/trading.js check              # Check config
node {baseDir}/scripts/trading.js account            # Balance
node {baseDir}/scripts/trading.js positions          # Current holdings
node {baseDir}/scripts/trading.js history            # Order history
node {baseDir}/scripts/trading.js portfolio-history  # Equity curve (1W default)
node {baseDir}/scripts/trading.js portfolio-history 1M  # 1D/1W/1M/3M/1A

Market Data

bash

node {baseDir}/scripts/trading.js quote AAPL         # Real-time quote
node {baseDir}/scripts/trading.js bars AAPL 30       # Price history
node {baseDir}/scripts/trading.js rsi AAPL 14        # RSI indicator

Trading

bash

node {baseDir}/scripts/trading.js buy AAPL 10        # Buy (market order)
node {baseDir}/scripts/trading.js sell AAPL 10       # Sell

Strategy

bash

node {baseDir}/scripts/trading.js strategy-rsi AAPL  # RSI mean reversion
# RSI < 30 + no position → BUY; RSI > 70 + has position → SELL

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

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

API Limits

Tier	Calls/min	Data delay
Free	200	15 min
Unlimited	Unlimited	Real-time

storyclaw-alpaca-trading

NPX Install

Tags

SKILL.md Content

Alpaca Trading - US Stock & Crypto Trading

Critical Rules

Multi-User Support

First-Time User Flow

Commands

Account & Positions

Market Data

Trading

Strategy

Features

Setup

API Limits