storyclaw-alpaca-trading

Alpaca 取引 — 米国株・暗号資産の取引

Alpaca API を利用して、米国株と暗号資産を取引します。ペーパートレード（シミュレーション、無料）と実取引の両方に対応しています。

重要なルール

1. 取引を実行する前に、必ずプランを提示し、明示的な確認を得てください
2. 事前に提案せず、cron ジョブを設定しないでください
3. 価格やデータを捏造せず、必ず実データを照会してください
4. ユーザーが何を取引したいかを決めつけず、まず確認してください

マルチユーザー対応

各ユーザーは、それぞれ credentials/{USER_ID}.json を持ちます。

{
  "apiKey": "YOUR_KEY",
  "apiSecret": "YOUR_SECRET",
  "baseUrl": "https://paper-api.alpaca.markets",
  "dataUrl": "https://data.alpaca.markets"
}

実取引に切り替えるには、baseUrl を https://api.alpaca.markets に変更します。

または、ALPACA_API_KEY と ALPACA_API_SECRET の環境変数を設定します。

初回ユーザーの手順

1. 認証情報を確認します：USER_ID=$TELEGRAM_USER_ID node {baseDir}/scripts/trading.js check
2. 何を取引したいか尋ねます（株式か暗号資産か、銘柄、金額、リスク）
3. 具体的なプランを提示します — 確認を待ってください
4. ユーザーの確認後にのみ実行します

コマンド

アカウントとポジション

node {baseDir}/scripts/trading.js check              # Check config
node {baseDir}/scripts/trading.js account            # Balance
node {baseDir}/scripts/trading.js positions          # Current holdings
node {baseDir}/scripts/trading.js history            # Order history
node {baseDir}/scripts/trading.js portfolio-history  # Equity curve (1W default)
node {baseDir}/scripts/trading.js portfolio-history 1M  # 1D/1W/1M/3M/1A

マーケットデータ

node {baseDir}/scripts/trading.js quote AAPL         # Real-time quote
node {baseDir}/scripts/trading.js bars AAPL 30       # Price history
node {baseDir}/scripts/trading.js rsi AAPL 14        # RSI indicator

取引

node {baseDir}/scripts/trading.js buy AAPL 10        # Buy (market order)
node {baseDir}/scripts/trading.js sell AAPL 10       # Sell

戦略

node {baseDir}/scripts/trading.js strategy-rsi AAPL  # RSI mean reversion
# RSI < 30 + no position → BUY; RSI > 70 + has position → SELL

機能

• 米国株と暗号資産（AAPL、TSLA、BTC、ETH など）
• ペーパートレードまたは実取引（認証情報によって異なります）
• リアルタイムの相場情報（無料プランでは15分遅延）
• 成行注文、テクニカル指標（RSI）
• 取引時間：株式は月曜〜金曜の9:30〜16:00 ET、暗号資産は24時間365日

セットアップ

1. https://app.alpaca.markets/brokerage/new-account で登録します
2. API キーとシークレットを生成します（Paper Trading セクション）
3. credentials/{USER_ID}.json を作成するか、環境変数を設定します

API の制限

プラン	呼び出し/分	データの遅延
無料	200	15分
無制限	無制限	リアルタイム