ai-trading-web

AI Multi-Agent Cryptocurrency Futures Platformは、Binance USD-M FuturesおよびOKXパーペチュアル・スワップ向けのプロダクション向け仮想通貨先物リサーチ・執行システムです。本システムはpnpmワークスペースとして構成されており、Next.jsウェブアプリケーションとNode.js APIを備え、Prisma経由のPostgreSQL、Redis、BullMQによってバックエンドが構築され、Docker Composeセットアップで提供されます。 核心となる原則は「AIはアドバイザリー（助言）のみ」であることです。エージェントが直接取引所アダプターを呼び出すことはできず、自動注文はDecision/Judgeパイプラインと決定論的なRisk Engineを通過した後でなければ、Trading Engineによる執行は行われません。 セキュリティとアカウント：マルチユーザー認証、Redisベースのセッション、CSRF保護、TOTP二要素認証、監査ログ、Argon2idパスワードハッシュ化、およびAES-256-GCMで暗号化されたプロバイダー資格情報を備えています。パスワードリセットは1つのメールトランスポート（SMTPまたは秘密鍵付きウェブフックURL）を通じて設定され、リセットリンクは15分で期限切れとなり、一度限り使用可能で、平文で保存またはログ記録されません。パスワード変更が成功すると、そのアカウントの既存セッションはすべて無効化されます。 取引所統合：Binance FuturesおよびOKXアダプターは、公開マーケットデータ、プライベートアカウント状態、ポジション、オープンオーダー、注文履歴、注文作成、キャンセル、および取引所がサポートしている場合の保護注文の修正をカバーしています。 市場および外部データ：リアルタイムマーケットストリーム、正規化されたキャンドル、インジケーター、ギャップ検出、バックフィル、Redisスナップショット、および /market のSocket.IO名前空間を提供します。別のインジェクションレイヤーがニュース、取引所告知、インシデント、センチメント、Reddit、マクロカレンダーを処理し、インジェクションキュー、重複排除、重要度スコアリングを経て、/external-data リアルタイムイベントを通じて配信されます。 AIインフラストラクチャ：境界付きツール呼び出し、エージェントライフサイクル管理、Decision Agent、Judgeコントロール、BullMQパイプラインスケジューリング、リプレイ、キャンセル、ヘルスレポートおよびメトリクスを備えた、プロバイダーに依存しないAIレイヤーを構築しています。 リスク、ポートフォリオおよびリサーチ：決定論的なリスク評価、ポートフォリオ・エクスポージャー制御、戦略割り当てとリバランシング、パフォーマンスおよびリフレクションループ、シャドウ/カナリア自己学習、バックテスト、検証、ベンチマーク、シミュレーション、ファクター発見および定量的推奨を提供します。 執行：キルスイッチを備えた取引所ベースのDEMO/LIVEトレーディング、べき等なクライアント注文ID、状態同期、TP/SL保護、およびPosition Managerを備え、/live-trading リアルタイムダッシュボード名前空間を通じて表示されます。 適応型TP/SLおよびPosition Manager：利確（TP）および損切り（SL）レベルを単に環境パーセンテージから導出するのではなく、決定論的なTrade Plan EngineがATR、サポート/レジスタンス、EMA20/EMA50、ADX、効率比、ブレイクアウト状態、市場構造、手数料、および設定されたリスク/リワード要件を使用して、状況をTREND_UP、TREND_DOWN、RANGING、BREAKOUT、またはHIGH_VOLATILITYに分類し、それに対応するプランタイプ（トレンド・プルバック、レンジ境界エントリーおよびターゲット、ブレイクアウト/リテスト、またはボラティリティ制御）を生成します。このエンジンは、不適切なエントリー位置、構造的に過剰なストップ、および純リワード/リスクがポリシーを下回るターゲットを拒否します。STOP_LOSS_PCTやRISK_REWARD_RATIOなどの設定は、ATRや構造データが利用できない場合のポリシーデフォルトおよびフォールバックとして機能します。エントリー後、Position Managerは取引所状態を同期し、ストップを建値プラス手数料バッファに移動させたり、十分な好転後にATRでトレイルさせたり、1Rで一部利確を行ったり、明示的な保護・手動・取引所・戦略承認によるクローズが発生するまで停滞したポジションを維持したり、アダプターを通じて保護注文の修正やキャンセル/再作成を行い、ポジションクローズ後に孤立した保護注文をクリーンアップしたりします。LIVE_POSITION_SYNC_INTERVAL_MSはデフォルトで30秒です。取引所の注文履歴インポートとLive Tradingダッシュボードは直近20件に制限されていますが、ポジションおよび安全/保護チェックは切り捨てられません。 セーフティゲート：デフォルトの安全設定は TRADING_MODE=DEMO です。執行前に、システムは GLOBAL_TRADING_ENABLED、LIVE_TRADING_ENABLED、検証済み接続状態、プロダクション接続権限、最近の認証、リスク承認TTL、エクスポージャー制限、レバレッジ制限、クールダウン、およびキルスイッチの状態を確認します。LIVEモードには LIVE_TRADING_ENABLED=true が必要であり、プロダクション取引所接続は明示的に有効にしない限り無効のままとなります。READMEでは、動作検証には専用のデモ/テストネット資格情報を使用し、出金可能なAPIキーは決して使用しないよう推奨しています。 セットアップおよび運用：要件はNode.js 22.13以降（pnpm 11に必要）、pnpm 11以降、およびDocker Composeを備えたDocker Desktopです。ローカルセットアップでは、.env.exampleをルート、apps/api、apps/webの各場所にコピーし、依存関係をインストールし、Compose経由でPostgres、Redis、Adminerを起動し、Prismaクライアントを生成し、マイグレーションを適用して開発サーバーを実行します。フルスタックは docker compose up -d --build でも起動可能です。ドキュメント化されたサービスには、ポート3000のウェブアプリ、/api、/docs、/api/healthを備えたポート3001のAPI、およびポート8080のAdminerが含まれます。スクリプトには、dev、build、lint、厳格なTypeScript型チェック、Vitestユニットスイート、API統合テスト、E2Eテスト、フォーマットチェック、およびPrismaのgenerate、migrate、studioが含まれます。詳細なドキュメントは ARCHITECTURE.md、API_CONTRACT.md、DATABASE.md、DIRECTORY_STRUCTURE.md、ROADMAP.md、PROJECT_CONTEXT.md、DEFINITION_OF_DONE.md、および PROJECT_RULES.md に記載されています。 プロジェクトが明示する既知の境界：評価および自己学習をサポートするペーパー/シャドウレコードは存在しますが、Live Tradingに匹敵する独立したペーパートレーディング執行APIはありません。バックテスト、デモ実行、およびモデルの信頼性は、プロダクションでの収益性を保証するものではなく、本番移行には十分なサンプルとドローダウンのレビューが必要です。コードの更新は、APIおよびウェブサービスが再ビルドまたは再起動されるまで、実行中のコンテナに影響しません。