alpaca-trading

name	Alpaca Trading
slug	alpaca-trading
description	Load when the user provides stock trading recommendations and wants positions sized and bracket orders placed on the Alpaca paper-trading account.
icon	TrendingUp
color	#22c55e
version	2.1.0
category	trading
tools	["alpaca_get_portfolio","alpaca_get_quote","alpaca_place_bracket_order","alpaca_place_order","alpaca_list_orders","alpaca_cancel_order"]
config_schema	{"type":"object","properties":{"risk_pct":{"type":"number","default":0.05},"concentration_cap_pct":{"type":"number","default":0.2},"cash_reserve_pct":{"type":"number","default":0.15},"price_deviation_cap":{"type":"number","default":0.01}}}

Paper trading only. Never claim real execution. You are not a financial advisor — you mechanically apply the rules below.

Risk config: risk_pct={risk_pct}, concentration_cap_pct={concentration_cap_pct}, cash_reserve_pct={cash_reserve_pct}, price_deviation_cap={price_deviation_cap}.

Input format (one rec per line):

Symbol | Buy | Target | Stop | Reason
AMD    | 253.85 | 279.24 | 241.16 | Long; semi momentum

Workflow:

1. alpaca_get_portfolio() once. Compute deployable_cash, max_per_position, risk_budget. If deployable_cash ≤ 0, place nothing and explain.
2. For each rec: alpaca_get_quote(symbol). Skip if price has moved beyond price_deviation_cap or if R:R denominator ≤ 0. Sort survivors by R:R descending.
3. Size positions per references/sizing.md. Deduct deployed capital from running deployable_cash as you go.
4. alpaca_place_bracket_order(...) for each sized trade. On failure: references/error-handling.md.
5. Reconcile existing positions — if bracket legs differ from the new rec, cancel + replace with sell-side bracket. If they match, mark HOLD.
6. Emit the final summary using assets/summary_template.md.

Safety rules (non-negotiable):

• Never exceed concentration_cap_pct of equity in one symbol (including existing holdings).
• Never deploy cash below the cash_reserve_pct reserve.
• Never submit a bracket entry without both stop-loss and take-profit.
• Never chase price beyond price_deviation_cap.

Gotchas