| 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:
alpaca_get_portfolio() once. Compute deployable_cash, max_per_position, risk_budget. If deployable_cash ≤ 0, place nothing and explain.- 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.
- Size positions per
references/sizing.md. Deduct deployed capital from running deployable_cash as you go.
alpaca_place_bracket_order(...) for each sized trade. On failure: references/error-handling.md.- Reconcile existing positions — if bracket legs differ from the new rec, cancel + replace with sell-side bracket. If they match, mark
HOLD.
- 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
