用途：该技能对接 Alpaca 券商公开 REST API，用于查询与操作美国股票及 ETF，无需本地网关，可直接在 Starchild 容器中运行。
主要能力：查看账户状态、持仓、订单（含成交明细）、单只标的报价与历史行情，并支持下单与撤单。模拟盘与实盘完全隔离，使用不同密钥与不同主机（paper-api.alpaca.markets 与 api.alpaca.markets），模拟盘密钥无法触及实盘账户；实盘下单还需额外加 --confirm-live 标志。
使用方式：先在 alpaca.markets 注册，模拟盘免费且无需入金。模拟盘密钥在登录后切换到 Paper Trading，进入 Home 的 API Keys 面板生成；实盘密钥在 Live Trading 下同样位置生成，与模拟盘是不同密钥对。密钥通过安全输入配置，不要粘贴到聊天中。环境变量包括 ALPACA_API_KEY、ALPACA_SECRET_KEY（模拟盘必填），ALPACA_LIVE_API_KEY、ALPACA_LIVE_SECRET_KEY（仅实盘），以及可选的 ALPACA_FEED（默认 iex，可选 sip）。首次运行需 pip install alpaca-py。所有命令输出 JSON，默认使用模拟盘配置。常用命令如 python skills/alpaca/scripts/alpaca_cli.py status、account、positions、orders [--executions]、quote --symbol AAPL、history --symbol AAPL --period 1d --limit 90；下单支持数量或金额、市价或限价，例如 place --symbol AAPL --side buy --qty 1 --type market，或 place --symbol AAPL --side buy --notional 500 --type limit --limit-price 180；撤单用 cancel --order-id <id>。实盘需同时加 --profile live 与 --confirm-live。周期支持 1m 5m 15m 30m 1h 1d 1w 1M，并支持按金额的碎股下单。
适用场景：需要程序化查询美股/ETF 账户与行情，或在模拟盘验证策略后谨慎执行实盘交易。
限制：免费 IEX 数据在非交易时段可能稀疏或延迟，SIP 全市场数据需付费订阅；实盘涉及真实资金，--confirm-live 为有意设置的门槛，不应自动添加。建议先运行 status 做健康检查，确认 SDK 安装状态、密钥是否存在并 ping 账户。