Communitygithub.com

lacymorrow/alpaca-trading-skill

AlpacaのREST APIをcurlで操作し、株式、ETF、オプション、暗号資産の取引を実行します。

alpaca-trading-skill とは?

このスキルは、AlpacaのREST APIを通じてポートフォリオ管理と取引を実行するためのツールです。株式、ETF、オプション、暗号資産(仮想通貨)の売買に加え、オプションの買い/売り(コール・プット)、カバードコール、キャッシュ担保プット、スプレッド、権利行使、契約照会、オプションチェーンデータなど、高度なオプション取引をフルサポートします。注文管理、ポジション管理、ウォッチリスト、口座活動履歴、ポートフォリオ履歴の取得も可能です。リアルタイムおよび過去の市場データ(株価、オプション、暗号資産のクォート、バー、スナップショット、ニュース、スクリーナー(最も活発な銘柄、トップムーバー)、コーポレートアクション)にもアクセスできます。外部のCLIバイナリは不要で、curlとjq(またはフォールバックとしてpython3)のみで動作します。特に「買う」「売る」「取引」「オプション」「コール」「プット」「市場データ」「株価」「ポートフォリオ」「残高」「ポジション」「注文」「アルパカ」「市場時計」「ウォッチリスト」「トップムーバー」「最も活発」といったキーワードや、株式/暗号資産/オプションの取引タスクに自動的に関連付けられます。

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

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

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

ドキュメント

Alpaca Trading Skill

scripts/alpaca.sh を使用して、AlpacaのREST API経由でポートフォリオの取引と管理を行います。

セットアップ

必要な環境変数

変数目的
APCA_API_KEY_IDAlpaca APIキー
APCA_API_SECRET_KEYAlpaca APIシークレット

オプションの環境変数

変数デフォルト値目的
APCA_API_BASE_URLhttps://paper-api.alpaca.markets取引用エンドポイント。本番環境では https://api.alpaca.markets に設定します
APCA_DATA_API_BASE_URLhttps://data.alpaca.markets市場データエンドポイント

ペーパートレーディングがデフォルトです。 本番環境に切り替える前に、必ずユーザーに確認してください。

ヘルパースクリプト

このスキルディレクトリから scripts/alpaca.sh をソースしてください。使用方法:

alpaca METHOD PATH [JSON_BODY]
# 市場データ:
ALPACA_DATA=1 alpaca METHOD PATH

クイックリファレンス

アカウントとポートフォリオ

alpaca GET /v2/account                                          # 残高、エクイティ、購買力
alpaca GET /v2/account/configurations                           # 取引設定
alpaca GET '/v2/account/portfolio/history?period=1M&timeframe=1D'  # ポートフォリオチャート
alpaca GET '/v2/account/activities?activity_types=FILL,DIV'     # 取引/配当履歴
alpaca GET /v2/clock                                            # 市場の開閉状況
alpaca GET '/v2/calendar?start=2026-03-01&end=2026-03-31'       # 取引日

注文 — 株式と暗号資産

# 成行買い(数量または金額指定)
alpaca POST /v2/orders '{"symbol":"AAPL","qty":"10","side":"buy","type":"market","time_in_force":"day"}'
alpaca POST /v2/orders '{"symbol":"AAPL","notional":"1000","side":"buy","type":"market","time_in_force":"day"}'

# 暗号資産(24時間365日)
alpaca POST /v2/orders '{"symbol":"BTC/USD","qty":"0.001","side":"buy","type":"market","time_in_force":"gtc"}'

# 指値/逆指値/ストップリミット/トレーリングストップ/ブレケット/OTO/OCO — 詳細は references/api.md を参照

# 注文一覧/取得/変更/取消
alpaca GET /v2/orders
alpaca GET /v2/orders/ORDER_ID
alpaca PATCH /v2/orders/ORDER_ID '{"qty":"20","limit_price":"190.00"}'
alpaca DELETE /v2/orders/ORDER_ID
alpaca DELETE /v2/orders                                        # 全注文取消

注文 — オプション

# コールの買い(レベル2以上)
alpaca POST /v2/orders '{"symbol":"AAPL260418C00260000","qty":"1","side":"buy","type":"market","time_in_force":"day"}'

# カバードコールの売り(レベル1以上、1契約あたり100株必要)
alpaca POST /v2/orders '{"symbol":"AAPL260418C00270000","qty":"1","side":"sell","type":"limit","limit_price":"2.00","time_in_force":"day"}'

# プットの買い/売り、キャッシュ担保プット、スプレッド(レベル3) — 詳細は references/api.md を参照

# オプションの権利行使
alpaca POST /v2/positions/AAPL260418C00260000/exercise

# 契約照会
alpaca GET '/v2/options/contracts?underlying_symbols=AAPL&expiration_date_gte=2026-04-01&type=call&limit=10'
alpaca GET /v2/options/contracts/AAPL260418C00260000

ポジション

alpaca GET /v2/positions                                        # 全オープンポジション
alpaca GET '/v2/positions?asset_class=us_option'                # オプションのみ
alpaca GET /v2/positions/AAPL                                   # 個別株式
alpaca GET /v2/positions/NVDA260417C00220000                    # 個別オプション
alpaca DELETE /v2/positions/AAPL                                # 決済
alpaca DELETE '/v2/positions/AAPL?qty=5'                        # 一部決済
alpaca DELETE '/v2/positions?cancel_orders=true'                # 全ポジション決済

市場データ — 株式

ALPACA_DATA=1 alpaca GET /v2/stocks/AAPL/snapshot               # クォート + 取引 + バー
ALPACA_DATA=1 alpaca GET '/v2/stocks/snapshots?symbols=AAPL,MSFT,GOOGL'  # マルチスナップショット
ALPACA_DATA=1 alpaca GET '/v2/stocks/AAPL/bars?timeframe=1Day&start=2026-03-01&limit=30'
ALPACA_DATA=1 alpaca GET /v1beta1/screener/stocks/most-actives
ALPACA_DATA=1 alpaca GET '/v1beta1/screener/stocks/movers?top=10'
ALPACA_DATA=1 alpaca GET '/v1beta1/news?symbols=AAPL&limit=5'

市場データ — オプション

ALPACA_DATA=1 alpaca GET '/v1beta1/options/snapshots/AAPL?feed=indicative&limit=10'  # オプションチェーン
ALPACA_DATA=1 alpaca GET '/v1beta1/options/bars?symbols=NVDA260417C00220000&timeframe=1Day&limit=10'
ALPACA_DATA=1 alpaca GET '/v1beta1/options/quotes/latest?symbols=NVDA260417C00220000'
ALPACA_DATA=1 alpaca GET '/v1beta1/options/trades/latest?symbols=NVDA260417C00220000'
# feed: indicative(無料/遅延)または opra(サブスクリプション必須)

市場データ — 暗号資産

ALPACA_DATA=1 alpaca GET '/v1beta3/crypto/us/latest/quotes?symbols=BTC/USD'
ALPACA_DATA=1 alpaca GET '/v1beta3/crypto/us/bars?symbols=BTC/USD&timeframe=1Day&limit=30'
ALPACA_DATA=1 alpaca GET '/v1beta3/crypto/us/snapshots?symbols=BTC/USD,ETH/USD'

コーポレートアクション

ALPACA_DATA=1 alpaca GET '/v1/corporate-actions?symbols=AAPL&types=cash_dividend'
# タイプ: forward_split, reverse_split, cash_dividend, stock_dividend, spin_off など

資産・ウォッチリスト

alpaca GET /v2/assets/AAPL                                      # 資産情報
alpaca GET '/v2/assets?status=active&attributes=has_options'     # オプション対応株式
alpaca GET /v2/watchlists                                       # ウォッチリスト一覧
alpaca POST /v2/watchlists '{"name":"テック","symbols":["AAPL","MSFT","GOOGL"]}'

全APIリファレンス

references/api.md を参照して完全なエンドポイントドキュメントを確認してください。以下の内容を含みます:

  • 全注文タイプ(指値、逆指値、ストップリミット、トレーリングストップ、ブレケット、OCO、OTO)
  • 注文フィールドリファレンス(side, type, time_in_force, order_class)
  • ウォッチリストCRUD
  • オプション契約
  • 履歴バー/取引/クォート(全クエリパラメータ)
  • 暗号資産エンドポイント
  • 市場カレンダー

安全ルール

  1. デフォルトはペーパートレーディング。 ユーザーの明示的な確認なしに APCA_API_BASE_URL を本番環境に設定しないでください。
  2. 注文JSONを送信前に表示する。 ユーザーに銘柄、数量、売買区分、タイプを確認させてください。
  3. 注文前に市場時計を確認する — 株式は市場時間(米国東部時間 9:30-16:00)外では取引できません。ただし、指値注文で extended_hours: true を設定した場合は除きます。
  4. 大口注文の前に購買力を確認する GET /v2/account で確認してください。
  5. 金融アドバイスは提供しない。 データを提示し、ユーザーが判断するようにしてください。
  6. 不可逆的な操作について警告する — 全ポジション決済、全注文取消など。

トラブルシューティング

症状対処方法
HTTP 401APCA_API_KEY_ID / APCA_API_SECRET_KEY が設定され、有効であることを確認
HTTP 403ペーパーキーを本番URLで使用、またはその逆。APCA_API_BASE_URL を確認
HTTP 422(数量不足)購買力、端数対応、または銘柄の有効性を確認
HTTP 429レート制限 — 待機して再試行。Alpacaは200リクエスト/分まで許可
時間外に注文が拒否される"extended_hours":true を追加(指値注文のみ)、または市場開始まで待機
jq: command not foundスクリプトは python3 -m json.tool にフォールバック。より良い出力のために jq をインストール

関連スキル