Alpaca Trading Skill
scripts/alpaca.sh を使用して、AlpacaのREST API経由でポートフォリオの取引と管理を行います。
セットアップ
必要な環境変数
| 変数 | 目的 |
|---|---|
APCA_API_KEY_ID | Alpaca APIキー |
APCA_API_SECRET_KEY | Alpaca APIシークレット |
オプションの環境変数
| 変数 | デフォルト値 | 目的 |
|---|---|---|
APCA_API_BASE_URL | https://paper-api.alpaca.markets | 取引用エンドポイント。本番環境では https://api.alpaca.markets に設定します |
APCA_DATA_API_BASE_URL | https://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
- オプション契約
- 履歴バー/取引/クォート(全クエリパラメータ)
- 暗号資産エンドポイント
- 市場カレンダー
安全ルール
- デフォルトはペーパートレーディング。 ユーザーの明示的な確認なしに
APCA_API_BASE_URLを本番環境に設定しないでください。 - 注文JSONを送信前に表示する。 ユーザーに銘柄、数量、売買区分、タイプを確認させてください。
- 注文前に市場時計を確認する — 株式は市場時間(米国東部時間 9:30-16:00)外では取引できません。ただし、指値注文で
extended_hours: trueを設定した場合は除きます。 - 大口注文の前に購買力を確認する
GET /v2/accountで確認してください。 - 金融アドバイスは提供しない。 データを提示し、ユーザーが判断するようにしてください。
- 不可逆的な操作について警告する — 全ポジション決済、全注文取消など。
トラブルシューティング
| 症状 | 対処方法 |
|---|---|
HTTP 401 | APCA_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 をインストール |