核心用法
Alpaca技能提供与Alpaca Markets经纪商API的完整集成，支持通过REST API进行程序化交易。主要功能涵盖三大模块：
交易执行：支持股票、期权和加密货币的订单管理，包括市价单/限价单/止损单等多种订单类型，提供订单创建、修改、取消及批量操作接口。
账户与持仓管理：实时获取账户余额、购买力、持仓明细，支持单仓平仓和一键清仓功能。
市场数据获取：对接Alpaca市场数据API，获取实时行情、历史K线数据及资产信息。
显著优点
- 双环境支持：内置纸面交易（paper trading）与实盘交易切换，默认使用模拟环境降低试错成本
- 合规经纪商背书：Alpaca Markets为美国SEC注册经纪商，受FINRA监管，资金隔离存放
- 零佣金交易：股票与ETF交易零佣金，API调用免费，降低自动化策略运营成本
- 机构级接口：支持 fractional shares（碎股交易）、多 leg options、24/7加密货币交易
- 完备的工具链：提供命令行脚本
alpaca_api.py与示例代码，集成OpenClaw代理配置
潜在缺点与局限性
- 地域限制：Alpaca Markets仅服务美国居民，国际用户需通过特定渠道开户
- 资产范围有限：相比Interactive Brokers等全功能券商，可交易资产类别较窄
- 依赖第三方基础设施：API可用性与延迟受Alpaca服务端稳定性影响
- 无原生 websocket 支持：技能层面仅封装REST API，实时行情需轮询
适合人群
- 量化交易者与算法交易策略开发者
- 需要自动化执行的美股/加密货币投资者
- 希望用模拟环境验证策略的初学者
- 构建智能投顾或财富管理AI Agent的开发者
常规风险
- 资金风险：实盘API密钥具备真实资金操作权限，泄露可能导致账户资金损失
- 策略风险：自动化交易缺乏人工干预机制，极端行情下可能产生意外亏损
- 合规风险：程序化交易需遵守SEC/FINRA规则，高频策略可能触发监管审查
- 技术风险：API限流、网络超时或订单状态同步延迟可能导致仓位不一致
- 建议措施：严格区分paper/live凭证，生产环境使用只读权限先行验证，设置每日最大损失限额与订单金额上限。