Communitygithub.com

lacymorrow/openclaw-alpaca-trading-skill

使用 apcacli 命令列工具執行交易、分析市場和管理投資組合,並與 Alpaca 的交易 API 整合。

openclaw-alpaca-trading-skill 是什麼?

此技能是一個專業的 AI 代理技能,旨在透過命令列工具 `apcacli` 與 Alpaca 交易平台進行互動。它支援股票、ETF、選擇權和加密貨幣的交易,並提供全面的投資組合管理功能,包括查看持倉、損益和帳戶資訊。使用者可以透過自然語言指令(例如「買 10 股 AAPL」)觸發交易操作,系統會自動轉換為對應的 `apcacli` 命令。該技能優先強調安全性,建議新用戶使用模擬交易來測試策略,並在執行前驗證市場時間、帳戶餘額和有效的股票代碼。它支援多種訂單類型,如市價單、限價單、停損單和移動停損單,並提供即時串流功能來監控帳戶事件和交易更新。此技能適用於 Any AI Agent(如 Claude 和 Codex),並要求使用者具備 Rust 1.71 以上環境、Alpaca 帳戶和 API 憑證。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Alpaca 交易技能

透過 apcacli 命令列工具執行交易並管理投資組合,與 Alpaca 的交易 API 整合。

安裝

apcacli 是一個 Rust 命令列工具。跨平台安裝方式如下:

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 的命令列工具,用於與 Alpaca 交易平台互動。它提供:

  • 交易功能:提交、修改和取消股票、ETF、選擇權和加密貨幣的訂單
  • 投資組合管理:查看持倉、損益和帳戶資訊
  • 市場數據:獲取資產資訊和市場時鐘狀態
  • 帳戶活動:追蹤交易歷史和帳戶變更
  • 即時串流:監控帳戶和交易事件

何時使用此技能

當使用者想要執行以下操作時使用此技能:

  • 執行交易(買/賣股票、ETF、選擇權、加密貨幣)
  • 檢查投資組合持倉和績效
  • 查看或管理訂單(已開、已成交、已取消)
  • 獲取帳戶餘額和購買力
  • 存取市場數據和資產資訊
  • 監控帳戶活動和事件
  • 檢查市場是否開盤
  • 設定停損或移動停損
  • 使用腳本自動化交易工作流程

常見觸發短語:

  • "買 10 股 AAPL"
  • "顯示我的持倉"
  • "我的帳戶餘額是多少?"
  • "列出我所有的訂單"
  • "取消訂單 [ID]"
  • "市場開盤了嗎?"
  • "顯示我的投資組合績效"
  • "為我的持倉設定停損"
  • "平倉所有持倉"

不應使用此技能的時機:

  • 使用者想要圖形化交易介面(引導他們使用網頁介面)
  • 使用者尋求財務建議(你提供工具,而非建議)
  • 使用者想要交易 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. 儲存回傳的 ORDER_ID
# 3. 檢查訂單狀態
apcacli order get <ORDER_ID>

# 4. 如有需要,取消訂單
apcacli order cancel <ORDER_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):帳戶餘額低於 2.5 萬美元時有 PDT 限制
  • 購買力:受限於帳戶權益和保證金要求
  • 訂單限制:某些訂單類型可能不適用於所有證券
  • 加密貨幣交易:可能具有不同的規則和交易時間

數據與效能

  • API 速率限制:Alpaca 有請求限制以防止濫用
  • 即時數據:可能需要活躍的數據訂閱
  • 指令輸出:結果以彩色編碼格式顯示,便於閱讀
  • 訂單 ID:儲存回傳的訂單 ID 以進行追蹤和管理
  • 網路依賴:需要網際網路連接至 Alpaca 的 API

疑難排解

環境變數未設定

# 錯誤:"缺少 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
...

[已截斷以利翻譯]

相關技能