Alpaca Trading Skill

An OpenClaw agent skill for trading stocks, ETFs, options, and crypto via Alpaca's REST API.

What it does

• Trade: Buy/sell stocks, ETFs, and crypto with all order types (market, limit, stop, trailing stop, bracket, OCO, OTO)
• Options: Full options trading — buy/sell calls & puts, covered calls, cash-secured puts, spreads, exercise contracts, option chain lookup & data (Levels 0-3)
• Portfolio: View positions (equity, options, crypto), account balance, buying power, portfolio history, account activities (fills, dividends, transfers, option events)
• Market Data: Real-time & historical quotes, bars, snapshots for stocks, options, and crypto. News, screener (most active, top movers), corporate actions (splits, dividends, mergers)
• Manage: Orders, watchlists, assets, account configuration, market clock & calendar

Requirements

• curl (standard on macOS/Linux)
• jq (optional, falls back to python3 -m json.tool)
• Alpaca API keys (sign up free)

No external CLI binaries or SDKs required.

Setup

Set your Alpaca API credentials as environment variables:

export APCA_API_KEY_ID="your-key-id"
export APCA_API_SECRET_KEY="your-secret-key"

Paper trading is the default. For live trading:

export APCA_API_BASE_URL="https://api.alpaca.markets"

Install

clawhub install lacymorrow/alpaca-trading-skill

Or clone directly:

git clone https://github.com/lacymorrow/alpaca-trading-skill.git ~/.openclaw/skills/alpaca-trading

Structure

├── SKILL.md              # Main skill file (loaded by OpenClaw)
├── scripts/
│   └── alpaca.sh         # Thin curl wrapper for Alpaca REST API
└── references/
    └── api.md            # Complete API endpoint reference

License

MIT