核心功能
Alpaca Trading Skill 是一套基于 REST API 的金融交易工具集，通过 curl + jq 实现与 Alpaca 券商平台的无缝对接。该 skill 覆盖了完整的投资交易生命周期：从账户查询、市场数据获取，到订单执行、持仓管理，再到投资组合历史追踪。
交易能力：支持股票、ETF、期权和加密货币的买卖操作，提供市价单、限价单、止损单、跟踪止损单、括号订单等多种订单类型。特别支持按金额（notional）或数量（qty）下单，满足灵活的交易策略需求。
市场数据：实时行情快照、历史 K 线数据、活跃股票筛选器（most active/top movers）、新闻资讯等数据接口一应俱全，为交易决策提供信息支撑。
安全设计：默认使用模拟交易环境（paper trading），所有实盘切换必须获得用户明确确认；执行前强制展示订单详情供复核；内置市场时钟检查，防止非交易时段误操作。
显著优点
1. 零依赖部署：无需安装外部二进制文件，纯 curl + jq 实现，兼容各类 POSIX 环境
2. 券商级基础设施：Alpaca 作为美国 SEC 注册经纪商，提供受监管的交易通道（SIPC 成员，FINRA 监管）
3. 现代交易特性：支持零佣金股票交易、加密货币交易、小数股（fractional shares）交易
4. 双环境隔离：Paper/Live 环境完全分离，API 密钥独立，从架构上降低实盘误操作风险
5. 完整的 API 覆盖：不仅覆盖基础交易，还包括期权链查询、观察列表管理、市场日历等进阶功能
潜在局限
1. 地域限制：Alpaca 仅服务美国市场，非美国居民开户受限；中国市场用户无法直接开户使用
2. 资产覆盖有限：相比 Interactive Brokers 等国际券商，可交易的市场范围较窄（主要为美股）
3. 依赖网络稳定性：REST API 调用对网络延迟敏感，高频交易场景可能存在劣势
4. 无原生 WebSocket：实时行情需轮询或额外接入 Alpaca 的 WebSocket 服务（本 skill 未封装）
5. 金融知识门槛：需理解订单类型、TIF（Time in Force）、买卖力量等专业概念
适合人群
- 量化交易开发者与算法交易学习者
- 需要程序化管理投资组合的个人投资者
- 希望以低成本（零佣金）进行美股交易的开发者
- 教育场景下的金融市场模拟交易演示
- 已具备 Alpaca 账户的现有用户
风险提示
资金风险：尽管默认模拟盘，误配置 APCA_API_BASE_URL 可能导致实盘交易。API 密钥泄露将直接导致账户资金损失。
合规风险：用户需自行确保交易行为符合所在司法管辖区的证券法规。本 skill 不提供投资建议，所有交易决策由用户独立承担。
市场风险：程序化交易可能因市场波动、流动性不足或系统故障导致意外损失。止损单等工具无法保证执行价格。
技术风险：API 限流（200 req/min）可能中断策略执行；网络故障可能导致订单状态同步延迟。