核心用法
Alpaca-py-cli 是基于 Python 的 CLI 交易工具，专为 AI 代理设计，实现 Alpaca Markets 的程序化交易。核心工作流分为配置验证、市场监控、订单执行和风险管理四个阶段。
配置与初始化：首次使用需运行 alpaca auth 交互式向导，将 API Key 和 Secret Key 保存至 shell 配置文件（~/.zshrc、~/.bashrc 或 ~/.profile），默认启用 Paper Trading（10万美元虚拟资金）。AI 代理可通过 alpaca init 获取注册指引，配合浏览器自动化完成开户流程。
市场与账户监控：alpaca clock 实时检测美股开盘状态（9:30-16:00 ET），alpaca account 显示账户余额、购买力及当日盈亏，alpaca positions 列出持仓明细与浮动损益，alpaca quote <symbols> 获取多股票实时报价。
订单执行：支持 alpaca buy/sell <symbol> <quantity> 市价单交易，alpaca orders 查看挂单状态，alpaca cancel <order_id> 或 alpaca cancel-all 撤销订单，alpaca close/close-all 平仓离场。
组合分析：alpaca history --period 1M --timeframe 1D 查看资产曲线，alpaca calendar --days 7 获取交易日历。
显著优点
- 零成本模拟：Paper Trading 默认开启，10万美元虚拟资金零风险练手
- 自然语言友好：代理可直接解析用户指令转为交易操作，无需记忆复杂 API
- 自动化就绪：
alpaca init非交互式设计，支持浏览器自动化完成开户全流程 - 实时数据覆盖：支持美股、加密货币报价，含盘前盘后时段
- 风险管理内置：
close-all需确认，cancel-all一键撤单，支持止损单设置
潜在缺点与局限性
- 地域限制：Alpaca Markets 仅服务美国居民，国际用户需确认合规性
- 资产范围有限：相比 Interactive Brokers，可交易品种较少
- 密钥存储风险：API keys 以明文环境变量形式存储于 shell 配置，多用户系统存在泄露风险
- LibreSSL 兼容性：macOS 系统 Python 可能出现 urllib3 警告，需切换 Homebrew Python
- 无高级订单类型：暂不支持条件单、OCO（一揽子取消其他）等复杂策略
适合人群
- 量化交易初学者：Paper Trading 零门槛入门
- AI 代理开发者：需要为 LLM 提供交易能力的 Agent 构建者
- 美股/加密货币日内交易者：需要快速 CLI 操作而非网页盯盘
- 自动化策略测试者：计划从模拟盘迁移至实盘的交易系统开发者
常规风险
- 资金风险：切换至 Live Trading 后涉及真实资金，建议 Paper 模式测试至少 1-2 个月
- 密钥泄露：shell 配置文件权限不当可能导致 API keys 被其他进程读取
- 市场波动：市价单在波动剧烈时可能以不利价格成交
- 代理误操作：AI 代理需明确用户授权方可执行
alpaca auth，避免未经同意的配置修改 - 合规风险：需自行确认所在司法管辖区对算法交易的监管要求