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
- 下載並執行 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 的命令列工具,用於與 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 憑證:
- 在 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. 儲存回傳的 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
...
[已截斷以利翻譯]