Communitygithub.com

lacymorrow/openclaw-alpaca-trading-skill

Alpaca Trading APIを使用して注執行、市場分析、ポートフォリオ管理をapcacliコマンドラインツールで行います。ユーザーが株式、ETF、オプション、暗号通貨の取引、市場データの確認、ポジション照会、注文管理、ポートフォリオ分析を求めたときに使用します。「買い」「売り」「取引」「市場データ」「株価」「ポートフォリオ」「口座残高」「alpaca trading」などのキーワードにも対応します。

openclaw-alpaca-trading-skill とは?

このスキルは、Alpacaの取引APIと連携するRust製CLIツール「apcacli」を介して、証券取引とポートフォリオ管理を実行するためのAIエージェントスキルです。ユーザーが「AAPLを10株買って」や「含み損益を表示して」といった自然言語の指示を出すと、スキルが適切なapcacliコマンドを生成・説明し、安全に取引を実行できるよう支援します。主な機能は、株式・ETF・オプション・暗号通貨の注文(成行・指値・ストップ・トレーリングストップなど)、ポジション管理、口座情報照会、市場データ取得、リアルタイムイベントストリーミングです。対応プラットフォームはAlpacaのペーパートレーディング(テスト環境)およびライブトレーディングで、APIキーとシークレットキーを環境変数で設定するだけで利用開始できます。このスキルは、コマンドを実行する前に市場時間や口座残高の確認を促すなど、安全性とベストプラクティスを重視して設計されており、初心者から上級者まで幅広いトレーダーが効率的に取引ワークフローを自動化・改善できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add lacymorrow/openclaw-alpaca-trading-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Alpaca取引スキル

apcacliコマンドラインツールを使用して、Alpacaの取引APIを介して注文執行とポートフォリオ管理を行います。

インストール

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='your-key-id'
export APCA_API_SECRET_KEY='your-secret-key'
# ライブ取引の場合(デフォルトはペーパー取引):
# export APCA_API_BASE_URL='https://api.alpaca.markets'

概要

あなたはapcacliを使ったコマンドライン株式取引のエキスパートです。目標は、安全性とベストプラクティスを重視しながら、AlpacaのAPIを介して株式、ETF、オプション、暗号通貨を効率的に取引できるようユーザーを支援することです。

このスキルの使い方

取引タスクを支援する際は、以下の手順に従ってください。

  1. 安全性第一:新しいユーザーやテスト時には必ずペーパートレーディングを推奨する
  2. コマンドの確認:取引を実行する前に正確なコマンドを表示する
  3. 前提条件の確認:市場時間、口座残高、有効なシンボルを確認する
  4. 注文タイプの説明:ユーザーのニーズに合った注文タイプを選ぶ手助けをする
  5. リスク管理:ストップロスやポジションサイズ調整を提案する

このスキルの機能

apcacliは、Alpacaの取引プラットフォームと対話するためのRustベースのCLIです。以下を提供します:

  • 取引:株式、ETF、オプション、暗号通貨の注文提出、変更、取消
  • ポートフォリオ管理:ポジション、損益、口座情報の表示
  • 市場データ:資産情報と市場時計ステータスの取得
  • 口座活動:取引履歴と口座変更の追跡
  • リアルタイムストリーミング:口座および取引イベントの監視

このスキルを使用するタイミング

以下のような場合にこのスキルを使用します:

  • 取引を実行する(株式、ETF、オプション、暗号通貨の売買)
  • ポートフォリオのポジションとパフォーマンスを確認する
  • 注文(未約定・約定済み・取消済み)を表示・管理する
  • 口座残高と買付余力を確認する
  • 市場データと資産情報を取得する
  • 口座活動とイベントを監視する
  • 市場が開いているか確認する
  • ストップロスやトレーリングストップを設定する
  • スクリプトで取引ワークフローを自動化する

よくあるトリガーフレーズ:

  • 「AAPLを10株買って」
  • 「保有ポジションを見せて」
  • 「口座残高は?」
  • 「すべての注文を表示して」
  • 「注文[ID]をキャンセルして」
  • 「市場は開いてる?」
  • 「ポートフォリオのパフォーマンスを見せて」
  • 「ポジションにストップロスを設定して」
  • 「すべてのポジションをクローズして」

このスキルを使用しない場合:

  • ユーザーがGUIベースの取引を希望する場合(Webインターフェースを案内する)
  • ユーザーが金融アドバイスを求める場合(ツールを提供するのであって推奨するわけではない)
  • ユーザーがAlpacaでサポートされていない銘柄を取引したい場合
  • ユーザーがapcacliをインストールしていない場合(先にインストールを支援する)

インストールとセットアップ

apcacliのインストール

# Cargo(Rustパッケージマネージャー)を使用
cargo install apcacli

# インストールの確認
apcacli --help

必要条件:

  • Rust 1.71以降
  • Alpacaアカウント(ペーパーまたはライブ取引)
  • Alpaca API認証情報

環境変数の設定

ペーパートレーディングの場合(テスト推奨):

export APCA_API_KEY_ID='your_paper_key_id'
export APCA_API_SECRET_KEY='your_paper_secret_key'
# ペーパートレーディングがデフォルトのため、APCA_API_BASE_URLの設定は不要

ライブトレーディングの場合:

export APCA_API_BASE_URL='https://api.alpaca.markets'
export APCA_API_KEY_ID='your_live_key_id'
export APCA_API_SECRET_KEY='your_live_secret_key'

API認証情報の取得:

  1. https://alpaca.markets/ にサインアップ
  2. ダッシュボードに移動
  3. APIキーを生成(ペーパーまたはライブ)
  4. 環境変数をエクスポート

基本コマンド

口座情報

口座詳細の表示:

apcacli account get

口座ステータス、現金残高、買付余力、純資産、証拠金情報を表示します。

口座活動の表示:

apcacli account activity

取引、配当、振替を含む最近の口座活動を表示します。

口座設定の更新:

apcacli account config <options>

口座設定を変更します(利用可能なオプションは--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 <ORDER_ID>

タイムスタンプ、価格、ステータスを含む注文の詳細情報を表示します。

注文の取消:

apcacli order cancel <ORDER_ID>

IDで保留中の注文をキャンセルします。

すべての注文を取消:

apcacli order cancel-all

すべての未約定注文をキャンセルします。

ポジション管理

すべてのオープンポジションを表示:

apcacli position list

以下の情報とともにすべてのオープンポジションを表示:

  • 数量と取得価格
  • 現在の市場価値
  • 日次損益(パーセンテージ付き)
  • 総損益(パーセンテージ付き)
  • 利益/損失の色分け表示

特定のポジションを取得:

apcacli position get <SYMBOL>

特定のポジションの詳細情報を表示します。

ポジションをクローズ:

# 全ポジションをクローズ
apcacli position close <SYMBOL>

# 部分クローズ
apcacli position close <SYMBOL> --quantity 5

すべてのポジションをクローズ:

apcacli position close-all

すべてのオープンポジションをクローズします。

資産情報

利用可能な資産を表示:

apcacli asset list

すべての取引可能な資産を表示します。

資産詳細を取得:

apcacli asset get <SYMBOL>

取引所、クラス、取引可能性ステータスを含む資産情報を表示します。

資産を検索:

apcacli asset search <QUERY>

クエリに一致する資産を検索します。

市場データ

市場時計を確認:

apcacli market clock

現在の市場ステータス(開場/閉場)、次のオープン時間、次のクローズ時間を表示します。

ストリーミング(リアルタイムイベント)

口座更新のストリーム:

apcacli stream account

注文更新や約定を含むリアルタイムの口座イベントを監視します。

取引更新のストリーム:

apcacli stream trades

ポジションに関するリアルタイムの取引イベントを監視します。

ベストプラクティス

安全性とリスク管理

  1. ペーパートレーディングから始める - まずはペーパートレーディングで戦略をテストする
  2. 指値注文を使用する - ボラティリティの高い状況では成行注文を避け、価格をコントロールする
  3. シンボルを確認する - 取引実行前にティッカーシンボルを再確認する
  4. 実行前に確認する - apcacli order getを使用して注文詳細を確認する
  5. ストップロスを設定する - ストップ注文でポジションを保護する
  6. 口座残高を確認する - 取引前に十分な買付余力があることを確認する
  7. ポジションを監視する - apcacli position listで定期的に損益を確認する

効果的な使用方法

  1. 各コマンドのヘルプを確認する - 詳細オプションにはapcacli <command> --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時)にのみ執行
  • パターンデイトレーディング(PDT):2万5千ドル未満の口座にはPDT制限あり
  • 買付余力:口座純資産と証拠金要件により制限
  • 注文制限:一部の注文タイプはすべての証券で利用できない場合あり
  • 暗号通貨取引:異なるルールと取引時間が適用される場合あり

データとパフォーマンス

  • APIレート制限:Alpacaには不正利用防止のためのリクエスト制限あり
  • リアルタイムデータ:アクティブなデータサブスクリプションが必要な場合あり
  • コマンド出力:結果は見やすいように色分けされてフォーマット
  • 注文ID:追跡と管理のために返された注文IDを保存
  • ネットワーク依存:AlpacaのAPIにアクセスするにはインターネット接続が必要

トラブルシューティング

環境変数が設定されていない

# エラー:「APCA_API_KEY_IDがありません」
# 解決策:必要な環境変数をエクスポート
export APCA_API_KEY_ID='your_key'
export APCA_API_SECRET_KEY='your_secret'

コマンドが見つからない

# エラー:「apcacli: command not found」
# 解決策:apcacliをインストール
cargo install apcacli

# インストールの確認
which apcacli

API認証失敗

  • API認証情報が正しいか確認
  • 正しいエンドポイント(ペーパー vs ライブ)を使用しているか確認
  • APIキーが失効していないか確認
  • 口座ステータスがアクティブであることを確認

注文が拒否された

  • 市場が開いているか確認(株式の場合)
  • 十分な買付余力があるか確認
  • シンボルが有効で取引可能か確認
  • 注文パラメータ(価格、数量)を確認
  • 口座に制限がないか確認

ポジションが見つからない

  • シンボルが正しいか確認
  • ポジションが実際にオープンしているか確認
  • 以前にポジションがクローズされていないか確認
  • 正しい口座(ペーパー vs ライブ)を使用しているか確認

高度な機能

シェル補完

より高速なコマンド入力のためにシェル補完を生成:

# 補完スクリプトのインストール
cargo run --bin=shell-complete > apcacli.bash
source apcacli.bash

# タブ補完が使用可能に
apcacli order <TAB>

監視用ストリーミング

ストリーミングコマンドを使用して口座活動をリアルタイムで監視:

# ターミナル1:口座イベントを監視
apcacli stream account

# ターミナル2:取引を実行
apcacli order submit buy AAPL

…

[翻訳のため省略]

参考

このスキルは、AIアシスタントがapcacliを効果的に使用するための知識を提供します。常に適切な権限を持ち、取引を行う前にユーザーの意図を確認してください。

関連スキル