mcpField
A
alpaca

alpaca

github.com/starchild-ai-agentその他2971 回インストール1 週間前に更新
リポジトリ

alpaca について

alpacaは、AlpacaのREST APIで口座、相場データ、ポジション、注文を確認するコマンドラインスキルです。ペーパー取引とライブ取引を分け、ライブ注文には明示的な確認を求めます。

主な機能

  1. 01ペーパー／ライブ口座の切り替え
  2. 02口座とポジションの確認
  3. 03気配値と履歴データの取得
  4. 04成行・指値注文
  5. 05JSON形式の出力

活用シーン

  1. 01口座状況と保有銘柄の確認
  2. 02銘柄の気配値や履歴の照会
  3. 03ペーパー取引の注文
  4. 04確認後のライブ注文

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/starchild-ai-agent/official-skills --skill alpaca

インストール後、Claude Code で/alpacaを入力して読み込まれたか確認します。

同梱ファイル_trade_report.pyscripts/alpaca_cli.py

詳細

これは何か

☁️ クラウドブローカー — Alpaca は公開 REST API を提供しているため、これは Starchild コンテナ内で直接動作します。ローカルゲートウェイは不要です。米国株式と ETF に対応しています。

ペーパーとライブは完全に分離されています: 異なるキーペア、異なるホスト（paper-api.alpaca.markets と api.alpaca.markets）。ペーパーキーは物理的にライブアカウントに触れることはできません。ライブでの注文発注にはさらに --confirm-live フラグが必要です。

API キーを取得する

  1. alpaca.markets でサインアップします（米国の証券会社。ペーパートレードは無料で、資金の入金は不要です）。
  2. ペーパーキー: ログイン → Paper Trading に切り替え（左上のトグル）→ Home → 「API Keys」パネル → Generate New Keys。Key ID と Secret Key をコピーします（シークレットは一度しか表示されません）。
  3. ライブキー（任意、実際の資金）: Live Trading に切り替え → 同じ API Keys パネル → 生成します。これらはペーパーとは異なるペアです。
  4. マーケットデータ: 無料の IEX フィードはそのまま使えます。SIP（全市場）には有料のデータ購読が必要です。

設定（.env）

安全な入力経由でリクエストしてください — チャットにキーを貼り付けないでください。変数:

変数必須備考
ALPACA_API_KEYはい（ペーパー）ペーパーの Key ID
ALPACA_SECRET_KEYはい（ペーパー）ペーパーの Secret
ALPACA_LIVE_API_KEYライブのみライブの Key ID
ALPACA_LIVE_SECRET_KEYライブのみライブの Secret
ALPACA_FEEDいいえiex（デフォルト）または sip

使用方法

pip install alpaca-py（初回実行時）。すべてのコマンドは JSON を出力します。デフォルトプロファイルは paper です。

python skills/alpaca/scripts/alpaca_cli.py status
python skills/alpaca/scripts/alpaca_cli.py account
python skills/alpaca/scripts/alpaca_cli.py positions
python skills/alpaca/scripts/alpaca_cli.py orders [--executions]
python skills/alpaca/scripts/alpaca_cli.py quote --symbol AAPL
python skills/alpaca/scripts/alpaca_cli.py history --symbol AAPL --period 1d --limit 90
# place (paper): qty OR notional, market OR limit
python skills/alpaca/scripts/alpaca_cli.py place --symbol AAPL --side buy --qty 1 --type market
python skills/alpaca/scripts/alpaca_cli.py place --symbol AAPL --side buy --notional 500 --type limit --limit-price 180
python skills/alpaca/scripts/alpaca_cli.py cancel --order-id <id>
# live: must add --profile live AND --confirm-live
python skills/alpaca/scripts/alpaca_cli.py --profile live --confirm-live place --symbol AAPL --side buy --qty 1

期間: 1m 5m 15m 30m 1h 1d 1w 1M。Alpaca は端株の --notional（ドル金額）注文をサポートしています。

注意点

  • status はヘルスチェックです — SDK のインストール状態、キーの有無を報告し、アカウントに ping を送ります。最初に実行してください。
  • 無料の IEX データは時間外に乏しかったり遅延したりすることがあります。sip はアカウントが有料フィードを持っている場合にのみ使用してください。
  • ライブトレードは実際の資金です。--confirm-live ゲートは意図的なものです。決して自動で追加しないでください。

コメント

Markdown 対応