SnapTradeポートフォリオ は何をしますか?
概要
SnapTradeを介して証券会社の口座に接続し、日次総額レポートを生成します。このスキルは公式のSnapTrade Python SDK(snaptrade_client)を使用し、リクエスト署名は自動的に処理されます。
ワークフロー
2d) 買い/売り注文の発注(株式/ETF)
実行:
python3 scripts/snaptrade_order.py buy|sell TICKER UNITS --account-id <ACCOUNT_ID> [--order-type market|limit] [--limit-price <PRICE>] [--tif Day|GTC|IOC|FOK]
デフォルト:
- 注文タイプ: market
- 有効期間: Day
- 指値価格: 指値注文の場合のみ必須
オプションの監視(最近の注文をポーリング):
python3 scripts/snaptrade_order.py buy|sell TICKER UNITS --account-id <ACCOUNT_ID> --watch
- デフォルトでは10秒ごとに最大120秒間ポーリング
--watch-intervalと--watch-secondsで調整可能
既存の注文をIDで監視:
python3 scripts/snaptrade_watch_order.py --account-id <ACCOUNT_ID> --order-id <BROKERAGE_ORDER_ID>
- 同じ10秒/120秒のデフォルト、
--watch-intervalと--watch-secondsで調整可能
ユーザーから問われた場合、口座注文エンドポイントを使用して約定を確認し、未約定の注文を報告します。
0) SnapTradeアカウントとAPIキーの作成
証券会社に接続するにはSnapTradeアカウントが必要です。https://snaptrade.com で無料アカウントを作成し、クライアントID と コンシューマーキー を生成して、スキル設定に追加してください。
1) 依存関係のインストール
pip3 install -r requirements.txt
2) 資格情報の設定(一度だけ)
資格情報をローカルの設定ファイルに保存します(コミットしないでください)。user_id は初回実行時に自動生成されます:
/home/openclaw/.openclaw/workspace/secrets/snaptrade.json
例:
{
"client_id": "YOUR_CLIENT_ID",
"consumer_key": "YOUR_CONSUMER_KEY",
"user_id": "<auto-generated-uuid>"
}
2) ユーザー登録と接続ポータルリンクの生成
実行:
python3 scripts/snaptrade_portal.py
これにより:
user_secretがない場合はユーザーを登録user_secretを設定ファイルに保存- 口座をリンクするためにユーザーが開く必要がある接続ポータルURLを表示
2b) 無効になった接続の再接続
実行:
python3 scripts/snaptrade_reconnect.py [brokerage-name]
これにより:
- 無効になった接続を一覧表示
- 再接続リンクを生成(証券会社名で一致させることも可能)
- ユーザーが接続を再有効化するための再接続URLを表示
2c) 利用可能な証券会社の一覧表示(許可された接続)
実行:
python3 scripts/snaptrade_brokers.py
これにより /snaptrade/partners を呼び出し、allowed_brokerages リスト(表示名)を返します。
3) ポートフォリオ総額の取得
実行:
python3 scripts/snaptrade_total.py
出力は以下のようなJSONです:
{"total_value": 123456.78, "currency": "CAD"}
3b) 証券会社ごとの残高(通貨換算)
実行:
python3 scripts/snaptrade_broker_totals.py --currency CAD
出力JSONには、選択した通貨での証券会社ごとの残高と、使用された為替レートが含まれます。
実装上の注意: 可能な限り get_user_holdings は避けてください。代わりに get_user_account_positions(ポジションエンドポイント)をポートフォリオ/ポジションデータに使用してください。ユーザーから明示的に要求された場合のみ、ホールディングスの残高/キャッシュを使用し、それ以外の場合はホールディングスを呼び出さないでください。
4) 日次レポートのスケジュール
cronを使用して snaptrade_total.py を呼び出し、簡潔なWhatsAppメッセージをフォーマットして、ユーザーに送信します。総額のみが必要です。
スクリプト
scripts/snaptrade_common.py— 設定の読み込み/保存とクライアント作成scripts/snaptrade_portal.py— ユーザー登録と接続ポータルリンクの生成scripts/snaptrade_reconnect.py— 無効になった接続の再接続リンクを生成scripts/snaptrade_brokers.py— このクライアントに許可された証券会社を一覧表示scripts/snaptrade_order.py— 買い/売り注文の発注(成行/指値)、オプションの監視機能付きscripts/snaptrade_watch_order.py— 既存の注文をIDで監視し、約定を確認scripts/snaptrade_total.py— 全口座の合計値を計算scripts/snaptrade_broker_totals.py— 証券会社ごとの残高(通貨換算あり)
注意事項
- リクエスト署名は、
consumer_keyを使用してSDKのrequest_after_hookによって処理されます。 - 合計値は、各口座の
account.balance.totalをホールディングスから合計することで計算されます。これにより、口座が追加または削除された場合のエラーを回避できます。 - 複数の通貨が存在する場合、スクリプトは最初に見つかった通貨を使用します。
- シークレットは
chmod 600のパーミッションでローカル設定ファイルに保管してください。