Alpaca Trading

核心用法

Alpaca Trading Skill 是一套基于 curl 的券商API封装方案，无需安装专用CLI工具即可调用 Alpaca Markets 的完整交易接口。用户通过环境变量配置 API 密钥后，使用 alpaca 辅助函数发起 REST 请求，覆盖账户查询、订单管理、持仓操作、实时行情、历史数据、观察列表等全链路功能。

显著优点

1. 全品类覆盖：支持美股、ETF、期权（含看涨/看跌、价差组合、行权）及加密货币的24/7交易
2. 零依赖设计：仅依赖 curl + jq，无需 Python 环境或官方 SDK，部署极轻量
3. 模拟盘优先：默认指向 paper-api 模拟环境，强制用户显式确认后才可切换实盘
4. 数据能力完善：提供实时报价、K线、快照、资金流向、新闻、财报日历、公司行为等多维数据

潜在局限

• 学习门槛：需理解 REST API 路径结构与 JSON 构造，非纯图形界面操作
• 地域限制：Alpaca Markets 主要服务美国市场，非美用户可能受开户限制
• 速率限制：200 req/min 的频次上限对高频策略存在瓶颈
• 期权权限分级：不同策略需对应账户等级（Level 1-3），新用户功能受限

适合人群

量化交易初学者、轻量级自动化策略开发者、需要快速验证交易逻辑而不愿搭建完整基础设施的用户，以及偏好命令行工作流的专业交易员。

常规风险

1. 资金风险：误配置 APCA_API_BASE_URL 可能导致实盘误操作，需严格遵循"先确认再切换"流程
2. 市场时机风险：美股常规交易时段外（9:30-16:00 ET）的市价单会被拒，需显式启用盘后交易或改用限价单
3. 流动性风险：期权合约流动性差异大，市价单在宽价差场景可能产生滑点
4. 合规边界：工具本身不提供投资建议，用户需自行承担交易决策责任

核心用法

alpaca-trading 是一个纯 Shell 实现的 Alpaca Markets API 封装工具，无需安装任何外部 CLI，仅依赖系统自带的 curl 和可选的 jq。用户通过 source scripts/alpaca.sh 获得 alpaca 命令，格式为 alpaca METHOD PATH [JSON_BODY]，市场数据查询需前置 ALPACA_DATA=1 环境变量。

功能覆盖极广：

• 账户管理：余额、购买力、配置、组合历史、交易记录、市场时钟
• 订单系统：支持股票/加密货币/期权的市场/限价/止损/跟踪止损/括号/OCO/OTO 等全类型订单，可按金额或数量下单
• 期权交易：完整支持买入看涨/看跌、卖出备兑看涨、现金担保看跌、价差策略、行权、合约查询、期权链数据
• 仓位管理：查询/平仓全部或部分持仓，支持按资产类别筛选
• 行情数据：实时报价、历史 K 线、多股快照、热门股票筛选器、新闻、公司行为（分红、拆股等）
• 加密货币：24/7 交易支持，完整的行情与交易接口

配置简单：仅需 APCA_API_KEY_ID 和 APCA_API_SECRET_KEY 两个环境变量，默认连接模拟交易环境（paper-api），需显式切换至实盘。

显著优点

• 零依赖部署：不引入任何第三方二进制，仅使用系统标准工具，部署成本极低
• 功能完整度高：覆盖 Alpaca 官方 API 的绝大多数功能，尤其是期权交易的深度支持在同类工具中罕见
• 安全设计：API 密钥强制走环境变量，无硬编码风险；全链路 HTTPS/TLS 加密
• 透明可控：Shell 脚本完全可读，每个 API 调用都显式构造，便于审计和定制
• 模拟优先：默认 paper trading，强制用户显式确认后才可切换实盘，降低误操作风险

潜在缺点与局限性

• 无高级功能：不支持条件单（OCO/OTO 需手动构造）、算法交易、智能路由等高级特性
• 输出格式化依赖 jq：若无 jq，JSON 输出可读性下降（虽提供 python3 回退）
• 无本地状态管理：无持仓缓存、无订单簿本地维护，完全依赖 API 查询
• 错误处理较基础：HTTP 状态码和错误信息直接透传，无结构化异常分类
• 速率限制需自行处理：Alpaca 限制 200 req/min，脚本层面无自动重试或退避逻辑

适合人群

• 需要快速验证交易策略的量化开发者
• 偏好命令行操作、追求极简工具链的轻量交易者
• 已熟悉 Alpaca API、希望用 Shell 脚本自动化日常操作的现有用户
• 需要在 CI/CD 或服务器环境中嵌入交易逻辑的系统工程师

常规风险

• 资金风险：涉及真实金融交易，期权和加密货币具有高风险，可能损失全部本金
• 操作风险：Shell 命令直接触发交易，误输入（如 qty 多写一位）可能导致意外下单
• 密钥泄露：环境变量虽安全，但若配置到 .bashrc 或日志中仍可能泄露
• API 变更：Alpaca API 版本迭代可能导致接口失效，需关注官方更新
• 网络可靠性：交易指令依赖网络连接，断网或延迟可能造成订单状态不确定
• 合规限制：Alpaca 服务有地域限制，部分国家/地区用户可能无法开户或使用