Alpaca 交易技能
通过 apcacli 命令行工具执行交易并管理 Alpaca 交易平台的投资组合。
安装
apcacli 是一个 Rust CLI。跨平台安装:
macOS (Homebrew)
brew install rustup
rustup-init -y
source "$HOME/.cargo/env"
cargo install apcacli
Linux
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source "$HOME/.cargo/env"
cargo install apcacli
Windows
- 下载并运行 rustup-init.exe
- 打开新终端,然后运行:
cargo install apcacli
环境变量
export APCA_API_KEY_ID='你的密钥ID'
export APCA_API_SECRET_KEY='你的秘密密钥'
# 实盘交易(默认是纸面交易):
# export APCA_API_BASE_URL='https://api.alpaca.markets'
概述
您是使用 apcacli 进行命令行股票交易的专家。您的目标是帮助用户通过 Alpaca 的 API 高效交易股票、ETF、期权和加密货币,同时强调安全性和最佳实践。
如何使用此技能
在帮助用户执行交易任务时:
- 安全第一:始终建议新用户或测试时使用纸面交易
- 验证命令:在执行交易前显示确切的命令
- 检查前置条件:确认市场时间、账户余额和有效股票代码
- 解释订单类型:帮助用户选择适合其需求的订单类型
- 风险管理:建议止损和仓位管理
此技能的作用
apcacli 是一个基于 Rust 的 CLI,用于与 Alpaca 的交易平台交互。它提供:
- 交易:提交、修改和取消股票、ETF、期权和加密货币的订单
- 投资组合管理:查看持仓、盈亏和账户信息
- 市场数据:访问资产信息和市场时钟状态
- 账户活动:跟踪交易历史和账户变更
- 实时流:监控账户和交易事件
何时使用此技能
当用户想要以下操作时使用此技能:
- 执行交易(买入/卖出入股票、ETF、期权、加密货币)
- 检查投资组合持仓和表现
- 查看或管理订单(未结、已成交、已取消)
- 获取账户余额和购买力
- 访问市场数据和资产信息
- 监控账户活动和事件
- 检查市场是否开盘
- 设置止损或追踪止损
- 使用脚本自动化交易工作流
常见触发短语:
- "买入 10 股 AAPL"
- "显示我的未结持仓"
- "我的账户余额是多少?"
- "列出我所有的订单"
- "取消订单 [ID]"
- "市场开盘了吗?"
- "显示我的投资组合表现"
- "在我的持仓上设置止损"
- "平掉我所有的持仓"
何时不 使用此技能:
- 用户想要基于 GUI 的交易(引导他们访问 Web 界面)
- 用户要求财务建议(您提供工具,而非建议)
- 用户想要交易 Alpaca 不支持的金融工具
- 用户没有安装 apcacli(先帮助他们安装)
安装与设置
安装 apcacli
# 使用 Cargo(Rust 包管理器)
cargo install apcacli
# 验证安装
apcacli --help
要求:
- Rust 1.71 或更新版本
- Alpaca 账户(纸面或实盘交易)
- Alpaca API 凭证
配置环境变量
对于纸面交易(建议用于测试):
export APCA_API_KEY_ID='你的纸面密钥ID'
export APCA_API_SECRET_KEY='你的纸面秘密密钥'
# 纸面交易是默认设置,无需设置 APCA_API_BASE_URL
对于实盘交易:
export APCA_API_BASE_URL='https://api.alpaca.markets'
export APCA_API_KEY_ID='你的实盘密钥ID'
export APCA_API_SECRET_KEY='你的实盘秘密密钥'
获取 API 凭证:
- 在 https://alpaca.markets/ 注册
- 导航到您的仪表板
- 生成 API 密钥(纸面或实盘)
- 导出环境变量
核心命令
账户信息
查看账户详情:
apcacli account get
显示账户状态、现金余额、购买力、净值和保证金信息。
查看账户活动:
apcacli account activity
显示最近的账户活动,包括交易、股息和转账。
更新账户配置:
apcacli account config <选项>
修改账户设置(使用 --help 查看可用选项)。
订单管理
提交市价单:
# 按金额买入
apcacli order submit buy AAPL --value 1000
# 按数量买入
apcacli order submit buy AAPL --quantity 10
# 卖出股票
apcacli order submit sell TSLA --quantity 5
提交限价单:
# 按指定价格买入
apcacli order submit buy MSFT --quantity 10 --limit-price 420
# 按指定价格卖出
apcacli order submit sell NVDA --quantity 20 --limit-price 850
提交高级订单:
# 止损单
apcacli order submit sell AAPL --quantity 10 --stop-price 180
# 止损限价单
apcacli order submit sell TSLA --quantity 5 --stop-price 800 --limit-price 795
# 追踪止损单(百分比)
apcacli order submit sell NVDA --quantity 10 --trail-percent 5
列出所有订单:
apcacli order list
显示所有订单及其状态(未结、已成交、已取消等)。
获取特定订单详情:
apcacli order get <订单ID>
显示全面的订单信息,包括时间戳、定价和状态。
取消订单:
apcacli order cancel <订单ID>
按 ID 取消待处理订单。
取消所有订单:
apcacli order cancel-all
取消所有未结订单。
持仓管理
列出所有未结持仓:
apcacli position list
显示所有未结持仓,包括:
- 数量和开仓价格
- 当前市值
- 每日盈亏(含百分比)
- 总盈亏(含百分比)
- 彩色盈亏显示
获取特定持仓:
apcacli position get <股票代码>
显示特定持仓的详细信息。
平仓:
# 平掉整个持仓
apcacli position close <股票代码>
# 平掉部分持仓
apcacli position close <股票代码> --quantity 5
平掉所有持仓:
apcacli position close-all
平掉所有未结持仓。
资产信息
列出可用资产:
apcacli asset list
显示所有可交易资产。
获取资产详情:
apcacli asset get <股票代码>
显示资产信息,包括交易所、类别和可交易状态。
搜索资产:
apcacli asset search <查询>
搜索与查询匹配的资产。
市场数据
检查市场时钟:
apcacli market clock
显示当前市场状态(开盘/收盘)、下次开盘时间和下次收盘时间。
流(实时事件)
流式账户更新:
apcacli stream account
实时监控账户事件,包括订单更新和成交。
流式交易更新:
apcacli stream trades
实时监控持仓的交易事件。
最佳实践
安全与风险管理
- 从纸面交易开始 - 始终先用纸面交易测试策略
- 使用限价单 - 在波动条件下避免使用市价单以更好地控制价格
- 验证股票代码 - 在执行交易前仔细检查股票代码
- 执行前审查 - 使用
apcacli order get验证订单详情 - 设置止损 - 使用止损单保护持仓
- 检查账户余额 - 确保交易前有足够的购买力
- 监控持仓 - 定期使用
apcacli position list检查盈亏
有效使用
- 检查任何命令的帮助 - 使用
apcacli <命令> --help查看详细选项 - 保存订单 ID - 存储返回的订单 ID 以便后续跟踪和管理
- 使用环境变量 - 将凭证安全保存在环境变量中,切勿硬编码
- 验证市场时间 - 在下单前使用
apcacli market clock检查 - 定期审查活动 - 监控账户活动以发现意外变更
常见工作流
简单股票购买:
# 1. 检查账户余额
apcacli account get
# 2. 验证资产是否可交易
apcacli asset get AAPL
# 3. 检查市场是否开盘
apcacli market clock
# 4. 提交市价单
apcacli order submit buy AAPL --value 1000
# 5. 验证持仓
apcacli position list
限价单及监控:
# 1. 提交限价单
apcacli order submit buy MSFT --quantity 10 --limit-price 420
# 2. 保存返回的订单ID
# 3. 检查订单状态
apcacli order get <订单ID>
# 4. 如果需要,取消订单
apcacli order cancel <订单ID>
投资组合审查:
# 1. 查看所有持仓
apcacli position list
# 2. 检查账户摘要
apcacli account get
# 3. 审查近期活动
apcacli account activity
带止损平仓:
# 1. 检查当前持仓
apcacli position get AAPL
# 2. 设置追踪止损以保护利润
apcacli order submit sell AAPL --quantity 10 --trail-percent 5
# 3. 监控订单
apcacli order list
命令参考快速指南
| 任务 | 命令 |
|---|---|
| 查看账户 | apcacli account get |
| 账户活动 | apcacli account activity |
| 买入股票(市价) | apcacli order submit buy SYMBOL --value AMOUNT |
| 买入股票(限价) | apcacli order submit buy SYMBOL --quantity N --limit-price PRICE |
| 卖出股票 | apcacli order submit sell SYMBOL --quantity N |
| 列出所有订单 | apcacli order list |
| 获取订单详情 | apcacli order get ORDER_ID |
| 取消订单 | apcacli order cancel ORDER_ID |
| 取消所有订单 | apcacli order cancel-all |
| 列出持仓 | apcacli position list |
| 获取持仓 | apcacli position get SYMBOL |
| 平仓 | apcacli position close SYMBOL |
| 平掉所有持仓 | apcacli position close-all |
| 列出资产 | apcacli asset list |
| 获取资产信息 | apcacli asset get SYMBOL |
| 检查市场状态 | apcacli market clock |
| 流式账户事件 | apcacli stream account |
| 流式交易 | apcacli stream trades |
订单类型与参数
基本订单参数
--quantity N- 要交易的股票数量--value AMOUNT- 投资金额(用于市价单)--limit-price PRICE- 限价单的限价--stop-price PRICE- 止损单的止损价--trail-percent N- 追踪止损百分比--trail-amount AMOUNT- 追踪止损金额
订单类型
市价单 - 以当前市场价格立即执行
apcacli order submit buy AAPL --quantity 10
限价单 - 仅按指定价格或更优价格执行
apcacli order submit buy AAPL --quantity 10 --limit-price 185
止损单 - 达到止损价时转为市价单
apcacli order submit sell AAPL --quantity 10 --stop-price 180
止损限价单 - 达到止损价时转为限价单
apcacli order submit sell AAPL --quantity 10 --stop-price 180 --limit-price 179
追踪止损单 - 止损价按指定百分比或金额跟踪市场
# 基于百分比
apcacli order submit sell AAPL --quantity 10 --trail-percent 5
# 基于金额
apcacli order submit sell AAPL --quantity 10 --trail-amount 10
重要说明
要求
- 必须安装 apcacli 二进制文件 - 通过
cargo install apcacli安装 - 必须设置环境变量 - 需要
APCA_API_KEY_ID和APCA_API_SECRET_KEY - Alpaca 账户 - 活跃的纸面或实盘交易账户
- Rust 1.71+ - 需要从源代码安装
交易限制
- 纸面 vs 实盘:默认是纸面交易;设置
APCA_API_BASE_URL以进行实盘交易 - 市场时间:大多数交易仅在市场时间(美国东部时间上午 9:30 - 下午 4:00)内执行
- 日内交易规则(PDT):账户余额低于 25,000 美元时受 PDT 限制
- 购买力:受账户净值和保证金要求限制
- 订单限制:某些订单类型可能不适用于所有证券
- 加密货币交易:可能有不同的规则和交易时间
数据与性能
- API 速率限制:Alpaca 有请求限制以防止滥用
- 实时数据:可能需要活跃的数据订阅
- 命令输出:结果采用彩色编码,便于阅读
- 订单 ID:保存返回的订单 ID 以便跟踪和管理
- 网络依赖:需要互联网连接以访问 Alpaca 的 API
故障排除
环境变量未设置
# 错误:“Missing APCA_API_KEY_ID”
# 解决方法:导出所需的环境变量
export APCA_API_KEY_ID='你的密钥'
export APCA_API_SECRET_KEY='你的秘密密钥'
命令未找到
# 错误:“apcacli: command not found”
# 解决方法:安装 apcacli
cargo install apcacli
# 验证安装
which apcacli
API 认证失败
- 验证 API 凭证是否正确
- 检查是否使用了正确的端点(纸面 vs 实盘)
- 确保 API 密钥未被吊销
- 确认账户状态处于激活状态
订单被拒绝
- 验证市场是否开盘(针对股票)
- 检查是否有足够的购买力
- 确认股票代码有效且可交易
- 检查订单参数(价格、数量)
- 检查是否存在账户限制
持仓未找到
- 验证股票代码是否正确
- 确保持仓确实未平仓
- 检查是否之前已经平仓
- 确认您使用的是正确的账户(纸面 vs 实盘)
高级功能
Shell 补全
生成 shell 补全以更快输入命令:
# 安装补全脚本
cargo run --bin=shell-complete > apcacli.bash
source apcacli.bash
# 现在可以使用 Tab 补全
apcacli order <TAB>
流式监控
使用流式命令实时监控账户活动:
# 终端 1:监控账户事件
apcacli stream account
# 终端 2:执行交易
apcacli order submit buy AAPL
[为翻译截断]