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
- rustup-init.exeをダウンロードして実行します。
- 新しいターミナルを開き、次を実行します:
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、オプション、暗号通貨を効率的に取引できるようユーザーを支援することです。
このスキルの使い方
取引タスクを支援する際は、以下の手順に従ってください。
- 安全性第一:新しいユーザーやテスト時には必ずペーパートレーディングを推奨する
- コマンドの確認:取引を実行する前に正確なコマンドを表示する
- 前提条件の確認:市場時間、口座残高、有効なシンボルを確認する
- 注文タイプの説明:ユーザーのニーズに合った注文タイプを選ぶ手助けをする
- リスク管理:ストップロスやポジションサイズ調整を提案する
このスキルの機能
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認証情報の取得:
- https://alpaca.markets/ にサインアップ
- ダッシュボードに移動
- APIキーを生成(ペーパーまたはライブ)
- 環境変数をエクスポート
基本コマンド
口座情報
口座詳細の表示:
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
ポジションに関するリアルタイムの取引イベントを監視します。
ベストプラクティス
安全性とリスク管理
- ペーパートレーディングから始める - まずはペーパートレーディングで戦略をテストする
- 指値注文を使用する - ボラティリティの高い状況では成行注文を避け、価格をコントロールする
- シンボルを確認する - 取引実行前にティッカーシンボルを再確認する
- 実行前に確認する -
apcacli order getを使用して注文詳細を確認する - ストップロスを設定する - ストップ注文でポジションを保護する
- 口座残高を確認する - 取引前に十分な買付余力があることを確認する
- ポジションを監視する -
apcacli position listで定期的に損益を確認する
効果的な使用方法
- 各コマンドのヘルプを確認する - 詳細オプションには
apcacli <command> --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時)にのみ執行
- パターンデイトレーディング(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を効果的に使用するための知識を提供します。常に適切な権限を持ち、取引を行う前にユーザーの意図を確認してください。