核心用法
Alpaca skill 为量化交易开发者提供一站式券商 API 集成方案，覆盖账户管理、订单执行、持仓监控及市场数据获取四大核心场景。
交易操作：支持股票、期权、加密货币三类资产的限价/市价/止损订单，提供下单、改单、撤单、全平仓位等完整订单生命周期管理。POST /v2/orders 为高频调用端点，支持多资产类型统一接口。
账户与持仓：GET /v2/account 获取实时资金与购买力，GET /v2/positions 拉取当前持仓及盈亏，支持按标的精准平仓或一键清仓。
环境隔离：内置 paper trading（paper-api.alpaca.markets）与 live trading（api.alpaca.markets）双环境，通过 ALPACA_BASE_URL 切换，零成本验证策略后再上实盘。
辅助工具：scripts/alpaca_api.py 封装 CLI 调用与错误码映射，example.py 提供账户查询与下单示例，降低接入门槛。
显著优点
- 零佣金结构：Alpaca 核心优势为美股零佣金交易，显著降低策略摩擦成本。
- Fractional Shares：支持碎股交易，小资金即可实现资产配置。
- RESTful 设计：标准 HTTP 语义，JSON 序列化，多语言 SDK 生态成熟。
- Paper Trading fidelity：模拟环境与生产环境 API 行为高度一致，回测可信度较高。
潜在局限与风险
- 市场覆盖有限：专注美股，港股、A股、期货、外汇无法通过本 skill 交易。
- 期权数据深度：期权链数据与 Greeks 计算能力弱于专业期权券商（如 Tastytrade、IBKR）。
- Rate Limiting：未披露明确限流阈值，高频策略需自行实现退避重试。
- 依赖第三方稳定性：Alpaca 服务端中断将直接影响订单执行，需设计故障降级。
适合人群
- 个人量化开发者与算法交易策略研究员
- 需自动化执行的中低频股票/加密策略（日线至分钟线级别）
- 希望用 Python/Node.js 快速搭建交易系统的全栈工程师
常规风险
- 资金安全风险：API 密钥泄露可导致账户被恶意操作，须通过环境变量或密钥管理服务隔离。
- 执行滑点风险：市价单在波动行情中成交价格偏离预期，建议限价单为主。
- 合规风险：美国 SEC/FINRA 监管框架下，算法交易需关注日内交易规则（PDT）及申报义务。
- 技术风险：网络超时或 API 变更导致订单状态不一致，需实现幂等性设计与状态对账机制。