Communitygithub.com

lacymorrow/openclaw-alpaca-trading-skill

使用 apcacli 命令行工具执行交易、分析市场并管理 Alpaca Trading API 的投资组合。当用户想要交易股票、ETF、期权、加密货币、查看市场数据、管理订单或分析其投资组合时使用。

openclaw-alpaca-trading-skill 是什么?

该技能通过 apcacli(一个基于 Rust 的命令行工具)提供与 Alpaca Trading API 的直接交互,允许开发者完全在终端环境中执行交易、管理投资组合和访问市场数据。它支持股票、ETF、期权和加密货币的订单提交、修改和取消,同时提供账户余额、持仓详情、盈亏(P/L)和订单历史的实时查询。该技能还支持纸面交易(默认)和实盘交易,并包含止损、追踪止损等高级订单类型以强化风险管理。为了确保安全,它优先推荐纸面交易进行测试,在提交前验证命令,并检查市场时间、账户余额和有效股票代码等前置条件。智能体使用该技能来满足用户的交易请求,例如“买入 10 股 AAPL”或“显示我的未结持仓”,并处理完整的交易工作流,包括安装指南、环境变量配置和最佳实践。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add lacymorrow/openclaw-alpaca-trading-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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

  1. 下载并运行 rustup-init.exe
  2. 打开新终端,然后运行: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、期权和加密货币,同时强调安全性和最佳实践。

如何使用此技能

在帮助用户执行交易任务时:

  1. 安全第一:始终建议新用户或测试时使用纸面交易
  2. 验证命令:在执行交易前显示确切的命令
  3. 检查前置条件:确认市场时间、账户余额和有效股票代码
  4. 解释订单类型:帮助用户选择适合其需求的订单类型
  5. 风险管理:建议止损和仓位管理

此技能的作用

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 凭证:

  1. 在 https://alpaca.markets/ 注册
  2. 导航到您的仪表板
  3. 生成 API 密钥(纸面或实盘)
  4. 导出环境变量

核心命令

账户信息

查看账户详情:

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

实时监控持仓的交易事件。

最佳实践

安全与风险管理

  1. 从纸面交易开始 - 始终先用纸面交易测试策略
  2. 使用限价单 - 在波动条件下避免使用市价单以更好地控制价格
  3. 验证股票代码 - 在执行交易前仔细检查股票代码
  4. 执行前审查 - 使用 apcacli order get 验证订单详情
  5. 设置止损 - 使用止损单保护持仓
  6. 检查账户余额 - 确保交易前有足够的购买力
  7. 监控持仓 - 定期使用 apcacli position list 检查盈亏

有效使用

  1. 检查任何命令的帮助 - 使用 apcacli <命令> --help 查看详细选项
  2. 保存订单 ID - 存储返回的订单 ID 以便后续跟踪和管理
  3. 使用环境变量 - 将凭证安全保存在环境变量中,切勿硬编码
  4. 验证市场时间 - 在下单前使用 apcacli market clock 检查
  5. 定期审查活动 - 监控账户活动以发现意外变更

常见工作流

简单股票购买:

# 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

[为翻译截断]

相关技能