alpaca-paper

name	alpaca-paper
description	Execute paper/live trades on Alpaca with strict risk controls, stop automation, and friction-aware planning.
metadata	{"openclaw":{"emoji":"🏦","requires":{"env":["APCA_API_KEY_ID","APCA_API_SECRET_KEY","APCA_API_BASE_URL"],"bins":["python3"]}}}

Alpaca Trading + Stop Management

Order Execution

${OPENCLAW_HOME:-$HOME/.openclaw}/tools/alpaca/execute_or_queue.sh \
  --symbol NVDA --side buy --qty 10 --type market

Market Data

python3 ${OPENCLAW_HOME:-$HOME/.openclaw}/tools/alpaca/market_data.py snapshot --symbol NVDA
python3 ${OPENCLAW_HOME:-$HOME/.openclaw}/tools/alpaca/market_data.py movers --top 20
python3 ${OPENCLAW_HOME:-$HOME/.openclaw}/tools/alpaca/market_data.py actives --by volume --top 20

Stop Automation (mandatory after fill)

Move stop to breakeven:

${OPENCLAW_HOME:-$HOME/.openclaw}/tools/alpaca/stop_manager.sh \
  move-stop-entry --symbol NVDA --offset-bps 5 --replace

Protect % of profits:

${OPENCLAW_HOME:-$HOME/.openclaw}/tools/alpaca/stop_manager.sh \
  protect-profit --symbol NVDA --protect-pct 50 --min-gain-pct 0.30 --replace

Dry-run safety check:

${OPENCLAW_HOME:-$HOME/.openclaw}/tools/alpaca/stop_manager.sh \
  protect-profit --symbol NVDA --protect-pct 60 --dry-run

Rules

• Never hold a position without a stop.
• After first favorable move, move stop to entry + small buffer.
• As unrealized gain increases, trail by locking 40-70% of gains.
• For long positions use sell-stops; for short positions use buy-stops.
• Always --replace old open stops when upgrading protection.
• Default TIF: gtc for persistent protection.

Allowed Structures

• Long equity
• Short equity
• Long calls / long puts
• Defined-risk option spreads

Friction and Edge Gate

Before order send, estimate spread + slippage + fees. Trade only if net expected edge remains positive after friction.