nofx/README.ja.md

🤖 NOFX - Agentic Trading OS

言語: English | 中文 | Українська | Русский | 日本語

公式Twitter: @nofx_ai

---

🚀 ユニバーサルAIトレーディングOS

NOFXは、統合アーキテクチャに基づいて構築されたユニバーサルAgenticトレーディングOSです。暗号通貨市場において 「マルチエージェント判断 → 統一リスク管理 → 低レイテンシ実行 → ライブ/ペーパーアカウントバックテスト」 のループを成功裏に完成させ、現在この技術スタックを 株式、先物、オプション、外国為替、およびすべての金融市場 に拡大しています。

🎯 コア機能

• ユニバーサルデータ＆バックテストレイヤー: クロスマーケット、クロスタイムフレーム、クロス取引所の統一表現とファクターライブラリにより、転移可能な「戦略メモリ」を蓄積
• マルチエージェント自己対戦＆自己進化: 戦略が自動的に競争し、最適なものを選択、アカウントレベルのPnLとリスク制約に基づいて継続的に反復
• 統合実行＆リスク管理: 低レイテンシルーティング、スリッページ/リスク管理サンドボックス、アカウントレベルの制限、ワンクリック市場切り替え

🏢 Amber.acの支援

👥 コアチーム

• Tinkle - @Web3Tinkle
• Zack - @0x_ZackH

💼 シードラウンド募集中

現在、シードラウンドの資金調達を行っています。

投資に関するお問い合わせは、TwitterでTinkleまたはZackにDMをお送りください。

パートナーシップおよび協業については、公式Twitter @nofx_aiにDMをお送りください。

---

⚠️ リスク警告: このシステムは実験的なものです。AI自動取引には大きなリスクが伴います。学習/研究目的、または少額でのテストのみを強く推奨します！

👥 開発者コミュニティ

Telegram開発者コミュニティに参加して、議論、アイデアの共有、サポートを受けましょう：

💬 NOFX開発者コミュニティ

---

🆕 最新情報（最新アップデート）

🚀 マルチ取引所対応！

NOFXは現在、3つの主要取引所をサポートしています：Binance、Hyperliquid、Aster DEX！

Hyperliquid取引所

高性能な分散型無期限先物取引所！

主な機能:

• ✅ フル取引サポート（ロング/ショート、レバレッジ、ストップロス/テイクプロフィット）
• ✅ 自動精度処理（注文サイズ＆価格）
• ✅ 統一トレーダーインターフェース（シームレスな取引所切り替え）
• ✅ メインネットとテストネットの両方をサポート
• ✅ APIキー不要 - Ethereum秘密鍵のみ

なぜHyperliquid？

• 🔥 中央集権型取引所より低い手数料
• 🔒 非カストディアル - 資金を自分で管理
• ⚡ オンチェーン決済による高速実行
• 🌍 KYC不要

クイックスタート:

1. MetaMaskの秘密鍵を取得（0xプレフィックスを削除）
2. config.jsonで"exchange": "hyperliquid"を設定
3. "hyperliquid_private_key": "your_key"を追加
4. 取引開始！

詳細は設定ガイドをご覧ください。

Aster DEX取引所（NEW! v2.0.2）

Binance互換の分散型無期限先物取引所！

主な機能:

• ✅ BinanceスタイルAPI（Binanceからの移行が簡単）
• ✅ Web3ウォレット認証（安全で分散型）
• ✅ 自動精度処理によるフル取引サポート
• ✅ CEXより低い取引手数料
• ✅ EVM互換（Ethereum、BSC、Polygonなど）

なぜAster？

• 🎯 Binance互換API - 最小限のコード変更で済む
• 🔐 APIウォレットシステム - セキュリティのための独立した取引ウォレット
• 💰 競争力のある手数料 - ほとんどの中央集権型取引所より低い
• 🌐 マルチチェーンサポート - お好みのEVMチェーンで取引

クイックスタート:

1. Aster APIウォレットにアクセス
2. メインウォレットを接続してAPIウォレットを作成
3. API Signerアドレスと秘密鍵をコピー
4. config.jsonで"exchange": "aster"を設定
5. "aster_user"、"aster_signer"、"aster_private_key"を追加

---

📸 スクリーンショット

🏆 競争モード - リアルタイムAIバトル

QwenとDeepSeekのライブトレーディングバトルを示すリアルタイムパフォーマンス比較チャート付きマルチAIリーダーボード

📊 トレーダー詳細 - 完全なトレーディングダッシュボード

エクイティカーブ、ライブポジション、展開可能な入力プロンプトと思考連鎖推論を持つAI判断ログを備えたプロフェッショナルな取引インターフェース

---

✨ 現在の実装 - 暗号通貨市場

NOFXは現在、以下の実証済み機能で暗号通貨市場において完全に稼働しています：

🏆 マルチエージェント競争フレームワーク

• ライブエージェントバトル: QwenとDeepSeekモデルがリアルタイム取引で競争
• 独立したアカウント管理: 各エージェントは独自の判断ログとパフォーマンスメトリクスを維持
• リアルタイムパフォーマンス比較: ライブROI追跡、勝率統計、一対一分析
• 自己進化ループ: エージェントは過去のパフォーマンスから学習し、継続的に改善

🧠 AI自己学習＆最適化

• 過去フィードバックシステム: 各判断前に過去20取引サイクルを分析
• スマートパフォーマンス分析:
  • 最高/最悪パフォーマンス資産の特定
  • 実際のUSDT建てで勝率、損益比、平均利益を計算
  • 繰り返しミスを回避（連続損失パターン）
  • 成功戦略を強化（高勝率パターン）
• 動的戦略調整: AIはバックテスト結果に基づいて取引スタイルを自律的に適応

📊 ユニバーサルマーケットデータレイヤー（暗号実装）

• マルチタイムフレーム分析: 3分リアルタイム + 4時間トレンドデータ
• テクニカル指標: EMA20/50、MACD、RSI(7/14)、ATR
• 建玉追跡: マーケットセンチメント、資金フロー分析
• 流動性フィルタリング: 低流動性資産（<1500万USD）の自動フィルタリング
• クロス取引所サポート: 統一データインターフェースでBinance、Hyperliquid、Aster DEX

🎯 統一リスク管理システム

• ポジション制限: 資産ごとの制限（アルトコイン≤1.5x エクイティ、BTC/ETH≤10x エクイティ）
• 設定可能なレバレッジ: 資産クラスとアカウントタイプに基づいて1xから50xまでの動的レバレッジ
• 証拠金管理: 総使用量≤90%、AI制御配分
• リスクリワード強制: 必須≥1:2 ストップロス対テイクプロフィット比率
• 重複防止: 同じ資産/方向での重複ポジションを防止

⚡ 低レイテンシ実行エンジン

• マルチ取引所API統合: Binance Futures、Hyperliquid DEX、Aster DEX
• 自動精度処理: 取引所ごとのスマートな注文サイズと価格フォーマット
• 優先実行: 既存ポジションを先にクローズし、その後新規を開く
• スリッページ管理: 実行前検証、リアルタイム精度チェック

🎨 プロフェッショナルモニタリングインターフェース

• Binanceスタイルダッシュボード: リアルタイム更新付きプロフェッショナルダークテーマ
• エクイティカーブ: 過去のアカウント価値追跡（USD/パーセンテージ切り替え）
• パフォーマンスチャート: ライブ更新付きマルチエージェントROI比較
• 完全な判断ログ: すべての取引の完全な思考連鎖（CoT）推論
• 5秒データ更新: リアルタイムアカウント、ポジション、損益更新

---

🔮 ロードマップ - ユニバーサルマーケット拡大

実証済みの暗号インフラストラクチャを以下に拡張中：

• 📈 株式市場: 米国株式、A株、香港株
• 📊 先物市場: 商品先物、指数先物
• 🎯 オプション取引: 株式オプション、暗号オプション
• 💱 外国為替市場: 主要通貨ペア、クロスレート

同じアーキテクチャ。同じエージェントフレームワーク。すべての市場。

---

🏗️ 技術アーキテクチャ

nofx/
├── main.go                          # プログラムエントリ（マルチトレーダーマネージャー）
├── config.json                      # 設定ファイル（APIキー、マルチトレーダー設定）
│
├── api/                            # HTTP APIサービス
│   └── server.go                   # Ginフレームワーク、RESTful API
│
├── trader/                         # トレーディングコア
│   ├── auto_trader.go              # 自動取引メインコントローラー（単一トレーダー）
│   └── binance_futures.go          # Binance先物APIラッパー
│
├── manager/                        # マルチトレーダー管理
│   └── trader_manager.go           # 複数のトレーダーインスタンスを管理
│
├── mcp/                            # Model Context Protocol - AI通信
│   └── client.go                   # AIクライアント（DeepSeek/Qwen統合）
│
├── decision/                       # AI判断エンジン
│   └── engine.go                   # 過去フィードバック付き判断ロジック
│
├── market/                         # マーケットデータ取得
│   └── data.go                     # マーケットデータ＆テクニカル指標（K線、RSI、MACD）
│
├── pool/                           # コインプール管理
│   └── coin_pool.go                # AI500 + OI Topマージプール
│
├── logger/                         # ロギングシステム
│   └── decision_logger.go          # 判断記録 + パフォーマンス分析
│
├── decision_logs/                  # 判断ログストレージ
│   ├── qwen_trader/                # Qwenトレーダーログ
│   └── deepseek_trader/            # DeepSeekトレーダーログ
│
└── web/                            # Reactフロントエンド
    ├── src/
    │   ├── components/             # Reactコンポーネント
    │   │   ├── EquityChart.tsx     # エクイティカーブチャート
    │   │   ├── ComparisonChart.tsx # マルチAI比較チャート
    │   │   └── CompetitionPage.tsx # 競争リーダーボード
    │   ├── lib/api.ts              # API呼び出しラッパー
    │   ├── types/index.ts          # TypeScript型
    │   ├── index.css               # BinanceスタイルCSS
    │   └── App.tsx                 # メインアプリ
    └── package.json

コア依存関係

バックエンド（Go）

• github.com/adshao/go-binance/v2 - Binance APIクライアント
• github.com/markcheno/go-talib - テクニカル指標計算（TA-Lib）
• github.com/gin-gonic/gin - HTTP APIフレームワーク

フロントエンド（React + TypeScript）

• react + react-dom - UIフレームワーク
• recharts - チャートライブラリ（エクイティカーブ、比較チャート）
• swr - データフェッチングとキャッシング
• tailwindcss - CSSフレームワーク

---

💰 Binanceアカウント登録（手数料節約！）

このシステムを使用する前に、Binance先物アカウントが必要です。紹介リンクを使用して取引手数料を節約しましょう：

🎁 Binance登録 - 手数料割引を取得

登録手順：

1. 上記のリンクをクリックしてBinance登録ページにアクセス
2. メール/電話番号で登録を完了
3. KYC認証を完了（先物取引に必要）
4. 先物アカウントを有効化：
   • Binanceホームページ → デリバティブ → USDT無期限先物
   • 「今すぐ開設」をクリックして先物取引を有効化
5. APIキーを作成：
   • アカウント → API管理
   • 新しいAPIキーを作成、「先物」権限を有効化
   • APIキーとシークレットキーを保存（config.jsonに必要）
   • 重要: セキュリティのためIPアドレスをホワイトリストに追加

手数料割引の利点：

• ✅ 現物取引: 最大30%の手数料割引
• ✅ 先物取引: 最大30%の手数料割引
• ✅ 生涯有効: すべての取引で永久割引

---

🚀 クイックスタート

🐳 オプションA：Dockerワンクリックデプロイ（最も簡単 - 初心者推奨！）

⚡ Dockerで3つの簡単なステップで取引開始 - インストール不要！

Dockerはすべての依存関係（Go、Node.js、TA-Lib）と環境設定を自動的に処理します。初心者に最適！

ステップ1：設定を準備

# 設定テンプレートをコピー
cp config.json.example config.json

# 編集してAPIキーを入力
nano config.json  # または任意のエディタを使用

ステップ2：ワンクリック起動

# オプション1：便利スクリプトを使用（推奨）
chmod +x start.sh
./start.sh start --build

> #### Docker Composeバージョンに関する注意
>
> **このプロジェクトはDocker Compose V2構文（スペース付き）を使用**
>
> 古いスタンドアロン`docker-compose`がインストールされている場合は、Docker DesktopまたはDocker 20.10+にアップグレードしてください

# オプション2：docker composeを直接使用
docker compose up -d --build

ステップ3：ダッシュボードにアクセス

ブラウザを開いて次にアクセス：http://localhost:3000

これで完了！🎉 AIトレーディングシステムが稼働中です！

システム管理

./start.sh logs      # ログを表示
./start.sh status    # ステータスを確認
./start.sh stop      # サービスを停止
./start.sh restart   # サービスを再起動

📖 詳細なDockerデプロイガイド、トラブルシューティング、高度な設定について：

• English: See DOCKER_DEPLOY.en.md
• 中文: 查看 DOCKER_DEPLOY.md
• 日本語: DOCKER_DEPLOY.ja.mdを参照

---

📦 オプションB：手動インストール（開発者向け）

注意: 上記のDockerデプロイを使用した場合は、このセクションをスキップしてください。手動インストールは、コードを変更したい場合、またはDockerなしで実行したい場合にのみ必要です。

1. 環境要件

• Go 1.21+
• Node.js 18+
• TA-Libライブラリ（テクニカル指標計算）

TA-Libのインストール

macOS:

brew install ta-lib

Ubuntu/Debian:

sudo apt-get install libta-lib0-dev

その他のシステム: TA-Lib公式ドキュメントを参照

2. プロジェクトをクローン

git clone https://github.com/tinkle-community/nofx.git
cd nofx

3. 依存関係をインストール

バックエンド:

go mod download

フロントエンド:

cd web
npm install
cd ..

4. AI APIキーを取得

システムを設定する前に、AI APIキーを取得する必要があります。以下のAIプロバイダーのいずれかを選択してください：

オプション1：DeepSeek（初心者推奨）

なぜDeepSeek？

• 💰 GPT-4より安価（約1/10のコスト）
• 🚀 高速レスポンス時間
• 🎯 優れた取引判断品質
• 🌍 VPNなしで世界中で動作

DeepSeek APIキーの取得方法：

1. アクセス: https://platform.deepseek.com
2. 登録: メール/電話番号でサインアップ
3. 認証: メール/電話認証を完了
4. チャージ: アカウントにクレジットを追加
   • 最低: 約$5 USD
   • 推奨: テスト用に$20-50 USD
5. APIキーを作成：
   • APIキーセクションに移動
   • 「新しいキーを作成」をクリック
   • キーをコピーして保存（sk-で始まる）
   • ⚠️ 重要: すぐに保存してください - 再度見ることはできません！

価格: 約100万トークンあたり$0.14（非常に安い！）

オプション2：Qwen（Alibaba Cloud）

Qwen APIキーの取得方法：

1. アクセス: https://dashscope.aliyuncs.com
2. 登録: Alibaba Cloudアカウントでサインアップ
3. サービスを有効化: DashScopeサービスを有効化
4. APIキーを作成：
   • APIキー管理に移動
   • 新しいキーを作成
   • コピーして保存（sk-で始まる）

注意: 登録には中国の電話番号が必要な場合があります

---

5. システム設定

2つの設定モードが利用可能：

• 🌟 初心者モード: シングルトレーダー + デフォルトコイン（推奨！）
• ⚔️ エキスパートモード: 複数トレーダー競争

🌟 初心者モード設定（推奨）

ステップ1: 設定例ファイルをコピーしてリネーム

cp config.json.example config.json

ステップ2: APIキーでconfig.jsonを編集

{
  "traders": [
    {
      "id": "my_trader",
      "name": "My AI Trader",
      "ai_model": "deepseek",
      "binance_api_key": "YOUR_BINANCE_API_KEY",
      "binance_secret_key": "YOUR_BINANCE_SECRET_KEY",
      "use_qwen": false,
      "deepseek_key": "sk-xxxxxxxxxxxxx",
      "qwen_key": "",
      "initial_balance": 1000.0,
      "scan_interval_minutes": 3
    }
  ],
  "leverage": {
    "btc_eth_leverage": 5,
    "altcoin_leverage": 5
  },
  "use_default_coins": true,
  "coin_pool_api_url": "",
  "oi_top_api_url": "",
  "api_server_port": 8080
}

ステップ3: プレースホルダーを実際のキーに置き換え

プレースホルダー	置き換え先	取得場所
YOUR_BINANCE_API_KEY	BinanceのAPIキー	Binance → アカウント → API管理
YOUR_BINANCE_SECRET_KEY	Binanceのシークレットキー	上記と同じ
sk-xxxxxxxxxxxxx	DeepSeek APIキー	platform.deepseek.com

ステップ4: 初期残高を調整（オプション）

• initial_balance: 実際のBinance先物アカウント残高に設定
• 損益パーセンテージの計算に使用
• 例：500 USDTがある場合、"initial_balance": 500.0に設定

✅ 設定チェックリスト：

• Binance APIキーを入力（引用符の問題なし）
• Binanceシークレットキーを入力（引用符の問題なし）
• DeepSeek APIキーを入力（sk-で始まる）
• use_default_coinsをtrueに設定（初心者向け）
• initial_balanceをアカウント残高と一致させる
• ファイルをconfig.jsonとして保存（.exampleではない）

---

🔷 代替：Hyperliquid取引所の使用

NOFXはHyperliquidもサポート - 分散型無期限先物取引所。Binanceの代わりにHyperliquidを使用するには：

ステップ1: Ethereum秘密鍵を取得（Hyperliquid認証用）

1. MetaMask（または任意のEthereumウォレット）を開く
2. 秘密鍵をエクスポート
3. キーから**0xプレフィックスを削除**
4. Hyperliquidでウォレットに資金を入金

ステップ2: Hyperliquid用にconfig.jsonを設定

{
  "traders": [
    {
      "id": "hyperliquid_trader",
      "name": "My Hyperliquid Trader",
      "enabled": true,
      "ai_model": "deepseek",
      "exchange": "hyperliquid",
      "hyperliquid_private_key": "your_private_key_without_0x",
      "hyperliquid_wallet_addr": "your_ethereum_address",
      "hyperliquid_testnet": false,
      "deepseek_key": "sk-xxxxxxxxxxxxx",
      "initial_balance": 1000.0,
      "scan_interval_minutes": 3
    }
  ],
  "use_default_coins": true,
  "api_server_port": 8080
}

Binance設定との主な違い:

• binance_api_key + binance_secret_keyをhyperliquid_private_keyに置き換え
• "exchange": "hyperliquid"フィールドを追加
• メインネットにはhyperliquid_testnet: false、テストネットにはtrueを設定

⚠️ セキュリティ警告: 秘密鍵は絶対に共有しないでください！メインウォレットではなく、取引専用のウォレットを使用してください。

---

🔶 代替：Aster DEX取引所の使用

NOFXはAster DEXもサポート - Binance互換の分散型無期限先物取引所！

なぜAsterを選ぶ？

• 🎯 Binance互換API（簡単な移行）
• 🔐 APIウォレットセキュリティシステム
• 💰 低い取引手数料
• 🌐 マルチチェーンサポート（ETH、BSC、Polygon）
• 🌍 KYC不要

ステップ1: Aster APIウォレットを作成

1. Aster APIウォレットにアクセス
2. メインウォレットを接続（MetaMask、WalletConnectなど）
3. 「APIウォレットを作成」をクリック
4. これらの3つの項目をすぐに保存：
   • メインウォレットアドレス（User）
   • APIウォレットアドレス（Signer）
   • APIウォレット秘密鍵（⚠️ 一度だけ表示！）

ステップ2: Aster用にconfig.jsonを設定

{
  "traders": [
    {
      "id": "aster_deepseek",
      "name": "Aster DeepSeek Trader",
      "enabled": true,
      "ai_model": "deepseek",
      "exchange": "aster",

      "aster_user": "0x63DD5aCC6b1aa0f563956C0e534DD30B6dcF7C4e",
      "aster_signer": "0x21cF8Ae13Bb72632562c6Fff438652Ba1a151bb0",
      "aster_private_key": "4fd0a42218f3eae43a6ce26d22544e986139a01e5b34a62db53757ffca81bae1",

      "deepseek_key": "sk-xxxxxxxxxxxxx",
      "initial_balance": 1000.0,
      "scan_interval_minutes": 3
    }
  ],
  "use_default_coins": true,
  "api_server_port": 8080,
  "leverage": {
    "btc_eth_leverage": 5,
    "altcoin_leverage": 5
  }
}

主要設定フィールド:

• "exchange": "aster" - 取引所をAsterに設定
• aster_user - メインウォレットアドレス
• aster_signer - APIウォレットアドレス（ステップ1から）
• aster_private_key - APIウォレット秘密鍵（0xプレフィックスなし）

📖 詳細なセットアップ手順については: Aster統合ガイドを参照

⚠️ セキュリティ注意事項:

• APIウォレットはメインウォレットとは別（追加のセキュリティレイヤー）
• API秘密鍵は絶対に共有しない
• asterdex.comでいつでもAPIウォレットアクセスを取り消し可能

---

⚔️ エキスパートモード：マルチトレーダー競争

複数のAIトレーダーが互いに競争する場合：

{
  "traders": [
    {
      "id": "qwen_trader",
      "name": "Qwen AI Trader",
      "ai_model": "qwen",
      "binance_api_key": "YOUR_BINANCE_API_KEY_1",
      "binance_secret_key": "YOUR_BINANCE_SECRET_KEY_1",
      "use_qwen": true,
      "qwen_key": "sk-xxxxx",
      "deepseek_key": "",
      "initial_balance": 1000.0,
      "scan_interval_minutes": 3
    },
    {
      "id": "deepseek_trader",
      "name": "DeepSeek AI Trader",
      "ai_model": "deepseek",
      "binance_api_key": "YOUR_BINANCE_API_KEY_2",
      "binance_secret_key": "YOUR_BINANCE_SECRET_KEY_2",
      "use_qwen": false,
      "qwen_key": "",
      "deepseek_key": "sk-xxxxx",
      "initial_balance": 1000.0,
      "scan_interval_minutes": 3
    }
  ],
  "use_default_coins": true,
  "coin_pool_api_url": "",
  "oi_top_api_url": "",
  "api_server_port": 8080
}

競争モードの要件:

• 2つの別々のBinance先物アカウント（異なるAPIキー）
• 両方のAI APIキー（Qwen + DeepSeek）
• テスト用により多くの資本（推奨：アカウントあたり500+ USDT）

---

📚 設定フィールド説明

フィールド	説明	例の値	必須？
id	このトレーダーの一意の識別子	"my_trader"	✅ はい
name	表示名	"My AI Trader"	✅ はい
enabled	このトレーダーが有効かどうか 起動をスキップする場合はfalseに設定	trueまたはfalse	✅ はい
ai_model	使用するAIプロバイダー	"deepseek"または"qwen"または"custom"	✅ はい
exchange	使用する取引所	"binance"または"hyperliquid"または"aster"	✅ はい
binance_api_key	Binance APIキー	"abc123..."	Binance使用時に必須
binance_secret_key	Binanceシークレットキー	"xyz789..."	Binance使用時に必須
hyperliquid_private_key	Hyperliquid秘密鍵 ⚠️ 0xプレフィックスを削除	"your_key..."	Hyperliquid使用時に必須
hyperliquid_wallet_addr	Hyperliquidウォレットアドレス	"0xabc..."	Hyperliquid使用時に必須
hyperliquid_testnet	テストネットを使用	trueまたはfalse	❌ いいえ（デフォルトはfalse）
use_qwen	Qwenを使用するかどうか	trueまたはfalse	✅ はい
deepseek_key	DeepSeek APIキー	"sk-xxx"	DeepSeek使用時
qwen_key	Qwen APIキー	"sk-xxx"	Qwen使用時
initial_balance	損益計算の開始残高	1000.0	✅ はい
scan_interval_minutes	判断を行う頻度	3（3-5推奨）	✅ はい
leverage	レバレッジ設定（v2.0.3+）	下記参照	✅ はい
btc_eth_leverage	BTC/ETHの最大レバレッジ ⚠️ サブアカウント：≤5x	5（デフォルト、安全） 50（メインアカウント最大）	✅ はい
altcoin_leverage	アルトコインの最大レバレッジ ⚠️ サブアカウント：≤5x	5（デフォルト、安全） 20（メインアカウント最大）	✅ はい
use_default_coins	組み込みコインリストを使用 ✨ スマートデフォルト：true（v2.0.2+） API URLが提供されていない場合自動有効化	trueまたは省略	❌ いいえ （オプション、自動デフォルト）
coin_pool_api_url	カスタムコインプールAPI use_default_coins: falseの場合のみ必要	""（空）	❌ いいえ
oi_top_api_url	建玉API オプション補足データ	""（空）	❌ いいえ
api_server_port	Webダッシュボードポート	8080	✅ はい

デフォルト取引コイン（use_default_coins: trueの場合）：

• BTC、ETH、SOL、BNB、XRP、DOGE、ADA、HYPE

---

⚙️ レバレッジ設定（v2.0.3+）

レバレッジ設定とは？

レバレッジ設定は、AIが各取引で使用できる最大レバレッジを制御します。これは、特にレバレッジ制限があるBinanceサブアカウントでリスク管理に重要です。

設定形式：

"leverage": {
  "btc_eth_leverage": 5,    // BTCとETHの最大レバレッジ
  "altcoin_leverage": 5      // その他すべてのコインの最大レバレッジ
}

⚠️ 重要：Binanceサブアカウント制限

• サブアカウント: Binanceにより**≤5xレバレッジ**に制限
• メインアカウント: 最大20x（アルトコイン）または50x（BTC/ETH）を使用可能
• サブアカウントを使用していてレバレッジを>5xに設定すると、取引は失敗し、エラーが表示されます：Subaccounts are restricted from using leverage greater than 5x

推奨設定：

アカウントタイプ	BTC/ETHレバレッジ	アルトコインレバレッジ	リスクレベル
サブアカウント	5	5	✅ 安全（デフォルト）
メイン（保守的）	10	10	🟡 中程度
メイン（積極的）	20	15	🔴 高
メイン（最大）	50	20	🔴🔴 非常に高

例：

安全な設定（サブアカウントまたは保守的）：

"leverage": {
  "btc_eth_leverage": 5,
  "altcoin_leverage": 5
}

積極的な設定（メインアカウントのみ）：

"leverage": {
  "btc_eth_leverage": 20,
  "altcoin_leverage": 15
}

AIのレバレッジ使用方法：

• AIは設定された最大値まで1xから任意のレバレッジを選択できます
• たとえば、altcoin_leverage: 20の場合、AIは市場条件に基づいて5x、10x、または20xを使用することを決定する可能性があります
• 設定は固定値ではなく上限を設定します
• AIはレバレッジを選択する際にボラティリティ、リスクリワード比率、アカウント残高を考慮します

---

⚠️ 重要：use_default_coinsフィールド

スマートデフォルト動作（v2.0.2+）：

次の場合、システムは自動的にuse_default_coins: trueをデフォルトにします：

• config.jsonにこのフィールドを含めていない、または
• falseに設定したがcoin_pool_api_urlを提供していない

これにより初心者に優しくなります！このフィールドを完全に省略することもできます。

設定例：

✅ オプション1：明示的に設定（明確性のため推奨）

"use_default_coins": true,
"coin_pool_api_url": "",
"oi_top_api_url": ""

✅ オプション2：フィールドを省略（デフォルトコインを自動使用）

// "use_default_coins"を含めないだけ
"coin_pool_api_url": "",
"oi_top_api_url": ""

⚙️ 高度：外部APIを使用

"use_default_coins": false,
"coin_pool_api_url": "http://your-api.com/coins",
"oi_top_api_url": "http://your-api.com/oi"

---

6. システムを実行

🚀 システムの起動（2ステップ）

システムには別々に実行される2つの部分があります：

1. バックエンド（AIトレーディングブレイン + API）
2. フロントエンド（監視用Webダッシュボード）

---

ステップ1：バックエンドを起動

ターミナルを開いて実行：

# プログラムをビルド（初回のみ、またはコード変更後）
go build -o nofx

# バックエンドを起動
./nofx

表示されるべきもの：

🚀 启动自动交易系统...
✓ Trader [my_trader] 已初始化
✓ API服务器启动在端口 8080
📊 开始交易监控...

⚠️ エラーが表示される場合：

エラーメッセージ	解決策
invalid API key	config.jsonのBinance APIキーを確認
TA-Lib not found	brew install ta-libを実行（macOS）
port 8080 already in use	config.jsonのapi_server_portを変更
DeepSeek API error	DeepSeek APIキーと残高を確認

✅ バックエンドが正しく実行されているとき：

• エラーメッセージなし
• "开始交易监控..."が表示される
• システムがアカウント残高を表示
• このターミナルウィンドウを開いたままにしてください！

---

ステップ2：フロントエンドを起動

新しいターミナルウィンドウを開き（最初のものは実行したまま）、次を実行：

cd web
npm run dev

表示されるべきもの：

VITE v5.x.x  ready in xxx ms

➜  Local:   http://localhost:3000/
➜  Network: use --host to expose

✅ フロントエンドが実行されているとき：

• "Local: http://localhost:3000/"メッセージ
• エラーメッセージなし
• このターミナルウィンドウも開いたままにしてください！

---

ステップ3：ダッシュボードにアクセス

Webブラウザを開いて次にアクセス：

🌐 http://localhost:3000

表示されるもの：

• 📊 リアルタイムアカウント残高
• 📈 オープンポジション（ある場合）
• 🤖 AI判断ログ
• 📉 エクイティカーブチャート

初回のヒント：

• 最初のAI判断まで3-5分かかることがあります
• 初期判断は「観望」（待機）と言う場合があります - これは正常です
• AIは最初に市場状況を分析する必要があります

---

7. システムを監視

監視すべきもの：

✅ 健全なシステムの兆候：

• バックエンドターミナルが3-5分ごとに判断サイクルを表示
• 継続的なエラーメッセージなし
• アカウント残高の更新
• Webダッシュボードの自動更新

⚠️ 警告の兆候：

• 繰り返されるAPIエラー
• 10分以上判断なし
• 残高の急速な減少

システムステータスの確認：

# 新しいターミナルウィンドウで
curl http://localhost:8080/health

戻り値：{"status":"ok"}

---

8. システムを停止

グレースフルシャットダウン（推奨）：

1. バックエンドターミナル（最初のもの）に移動
2. Ctrl+Cを押す
3. "系统已停止"メッセージを待つ
4. フロントエンドターミナル（2番目のもの）に移動
5. Ctrl+Cを押す

⚠️ 重要：

• 常にバックエンドを最初に停止
• ターミナルを閉じる前に確認を待つ
• 強制終了しない（ターミナルを直接閉じない）

---

📖 AI判断フロー

各判断サイクル（デフォルト3分）で、システムは以下のインテリジェントプロセスを実行します：

┌──────────────────────────────────────────────────────────┐
│ 1. 📊 過去パフォーマンスを分析（過去20サイクル）           │
├──────────────────────────────────────────────────────────┤
│  ✓ 総合勝率、平均利益、損益比を計算                       │
│  ✓ コインごとの統計（勝率、平均損益（USDT））             │
│  ✓ 最高/最悪パフォーマンスコインを特定                    │
│  ✓ 正確なPnLを含む最後の5取引の詳細をリスト              │
│  ✓ リスク調整パフォーマンスのシャープレシオを計算          │
│  📌 NEW（v2.0.2）：レバレッジを含む正確なUSDT PnL         │
└──────────────────────────────────────────────────────────┘
                           ↓
┌──────────────────────────────────────────────────────────┐
│ 2. 💰 アカウントステータスを取得                           │
├──────────────────────────────────────────────────────────┤
│  • 総エクイティと利用可能残高                             │
│  • オープンポジション数と未実現損益                       │
│  • 証拠金使用率（AIは最大90%を管理）                      │
│  • 日次損益追跡とドローダウン監視                         │
└──────────────────────────────────────────────────────────┘
                           ↓
┌──────────────────────────────────────────────────────────┐
│ 3. 🔍 既存ポジションを分析（ある場合）                     │
├──────────────────────────────────────────────────────────┤
│  • 各ポジションについて、最新の市場データを取得           │
│  • リアルタイムのテクニカル指標を計算：                   │
│    - 3分K線：RSI(7)、MACD、EMA20                         │
│    - 4時間K線：RSI(14)、EMA20/50、ATR                    │
│  • ポジション保有期間を追跡（例：「2時間15分」）          │
│    📌 NEW（v2.0.2）：各ポジションの保有期間を表示         │
│  • 表示：エントリー価格、現在価格、損益%、期間            │
│  • AIが評価：保持するかクローズするか？                   │
└──────────────────────────────────────────────────────────┘
                           ↓
┌──────────────────────────────────────────────────────────┐
│ 4. 🎯 新しい機会を評価（候補コイン）                       │
├──────────────────────────────────────────────────────────┤
│  • コインプールを取得（2モード）：                        │
│    🌟 デフォルトモード：BTC、ETH、SOL、BNB、XRPなど       │
│    ⚙️  高度モード：AI500（上位20）+ OI Top（上位20）     │
│  • 候補コインをマージして重複削除                         │
│  • フィルター：低流動性を削除（<1500万USD OI値）          │
│  • 市場データ + テクニカル指標をバッチ取得                │
│  • ボラティリティ、トレンド強度、出来高急増を計算        │
└──────────────────────────────────────────────────────────┘
                           ↓
┌──────────────────────────────────────────────────────────┐
│ 5. 🧠 AI総合判断（DeepSeek/Qwen）                         │
├──────────────────────────────────────────────────────────┤
│  • 過去フィードバックをレビュー：                         │
│    - 最近の勝率と利益率                                   │
│    - 最高/最悪コインパフォーマンス                        │
│    - 繰り返しミスを回避                                   │
│  • すべての生シーケンスデータを分析：                     │
│    - 3分価格シーケンス、4時間K線シーケンス                │
│    - 完全な指標シーケンス（最新のみではない）             │
│    📌 NEW（v2.0.2）：AIは分析の完全な自由を持つ          │
│  • 思考連鎖（CoT）推論プロセス                            │
│  • 構造化された判断を出力：                               │
│    - アクション：close_long/close_short/open_long/open_short│
│    - コインシンボル、数量、レバレッジ                     │
│    - ストップロスとテイクプロフィットレベル（≥1:2比率）   │
│  • 判断：待機/保持/クローズ/オープン                      │
└──────────────────────────────────────────────────────────┘
                           ↓
┌──────────────────────────────────────────────────────────┐
│ 6. ⚡ 取引を実行                                           │
├──────────────────────────────────────────────────────────┤
│  • 優先順位：既存をクローズ → その後新規をオープン       │
│  • 実行前のリスクチェック：                               │
│    - ポジションサイズ制限（アルトコイン1.5x、BTC 10x）    │
│    - 重複ポジションなし（同じコイン + 方向）              │
│    - 証拠金使用量が90%制限内                              │
│  • Binance LOT_SIZE精度を自動取得して適用                 │
│  • Binance Futures APIで注文を実行                        │
│  • クローズ後：すべての保留注文を自動キャンセル           │
│  • 実際の実行価格と注文IDを記録                           │
│  📌 期間計算のためにポジションオープン時間を追跡          │
└──────────────────────────────────────────────────────────┘
                           ↓
┌──────────────────────────────────────────────────────────┐
│ 7. 📝 完全なログを記録してパフォーマンスを更新             │
├──────────────────────────────────────────────────────────┤
│  • decision_logs/{trader_id}/に判断ログを保存             │
│  • ログには以下が含まれます：                             │
│    - 完全な思考連鎖（CoT）                                │
│    - すべての市場データを含む入力プロンプト               │
│    - 構造化された判断JSON                                 │
│    - アカウントスナップショット（残高、ポジション、証拠金）│
│    - 実行結果（成功/失敗、価格）                          │
│  • パフォーマンスデータベースを更新：                     │
│    - symbol_sideキーでオープン/クローズペアをマッチ       │
│      📌 NEW：ロング/ショート競合を防止                    │
│    - 正確なUSDT PnLを計算：                               │
│      PnL = ポジション価値 × 価格変化% × レバレッジ        │
│      📌 NEW：数量 + レバレッジを考慮                      │
│    - 保存：数量、レバレッジ、オープン時間、クローズ時間   │
│    - 更新：勝率、利益率、シャープレシオ                   │
│  • パフォーマンスデータは次のサイクルにフィードバック     │
└──────────────────────────────────────────────────────────┘
                           ↓
                    （3-5分ごとに繰り返し）

v2.0.2の主な改善点

📌 ポジション期間追跡：

• システムが各ポジションの保有期間を追跡
• ユーザープロンプトに表示：「持仓时长2小时15分钟」
• AIが出口タイミングについてより良い判断を下すのに役立つ

📌 正確なPnL計算：

• 以前：パーセンテージのみ（100U@5% = 1000U@5% = 両方とも「5.0」と表示）
• 現在：実際のUSDT利益 = ポジション価値 × 価格変化 × レバレッジ
• 例：1000 USDT × 5% × 20x = 1000 USDT実際の利益

📌 AI自由度の向上：

• AIはすべての生シーケンスデータを自由に分析可能
• 事前定義された指標の組み合わせに制限されない
• 独自のトレンド分析、サポート/レジスタンス計算を実行可能

📌 改善されたポジション追跡：

• symbol_sideキーを使用（例：「BTCUSDT_long」）
• ロングとショートの両方を保有する際の競合を防止
• 完全なデータを保存：数量、レバレッジ、オープン/クローズ時間

---

🧠 AI自己学習の例

過去フィードバック（プロンプトに自動追加）

## 📊 過去パフォーマンスフィードバック

### 総合パフォーマンス
- **総取引数**: 15（利益：8 | 損失：7）
- **勝率**: 53.3%
- **平均利益**: +3.2% | 平均損失：-2.1%
- **損益比**: 1.52:1

### 最近の取引
1. BTCUSDT LONG: 95000.0000 → 97500.0000 = +2.63% ✓
2. ETHUSDT SHORT: 3500.0000 → 3450.0000 = +1.43% ✓
3. SOLUSDT LONG: 185.0000 → 180.0000 = -2.70% ✗
4. BNBUSDT LONG: 610.0000 → 625.0000 = +2.46% ✓
5. ADAUSDT LONG: 0.8500 → 0.8300 = -2.35% ✗

### コインパフォーマンス
- **最高**: BTCUSDT（勝率75%、平均+2.5%）
- **最悪**: SOLUSDT（勝率25%、平均-1.8%）

AIのフィードバック使用方法

1. 連続損失を回避: SOLUSDTが3回連続でストップロスになっているのを見て、AIは回避するかより慎重になる
2. 成功戦略を強化: BTCブレイクアウトロングが75%の勝率で、AIはこのパターンを継続
3. 動的スタイル調整: 勝率<40% → 保守的；損益比>2 → 積極的を維持
4. 市場状況の特定: 連続損失は荒れた市場を示す可能性があり、取引頻度を減らす

---

📊 Webインターフェース機能

1. 競争ページ

• 🏆 リーダーボード: リアルタイムROIランキング、ゴールドボーダーでリーダーをハイライト
• 📈 パフォーマンス比較: デュアルAI ROIカーブ比較（紫対青）
• ⚔️ 一対一: リードマージンを示す直接比較
• リアルタイムデータ: 総エクイティ、損益%、ポジション数、証拠金使用量

2. 詳細ページ

• エクイティカーブ: 過去トレンドチャート（USD/パーセンテージ切り替え）
• 統計: 総サイクル、成功/失敗、オープン/クローズ統計
• ポジションテーブル: すべてのポジション詳細（エントリー価格、現在価格、損益%、清算価格）
• AI判断ログ: 最近の判断記録（展開可能なCoT）

3. リアルタイム更新

• システムステータス、アカウント情報、ポジションリスト：5秒更新
• 判断ログ、統計：10秒更新
• エクイティチャート：10秒更新

---

🎛️ APIエンドポイント

競争関連

GET /api/competition          # 競争リーダーボード（全トレーダー）
GET /api/traders              # トレーダーリスト

単一トレーダー関連

GET /api/status?trader_id=xxx            # システムステータス
GET /api/account?trader_id=xxx           # アカウント情報
GET /api/positions?trader_id=xxx         # ポジションリスト
GET /api/equity-history?trader_id=xxx    # エクイティ履歴（チャートデータ）
GET /api/decisions/latest?trader_id=xxx  # 最新5判断
GET /api/statistics?trader_id=xxx        # 統計

システムエンドポイント

GET /health                   # ヘルスチェック
GET /api/config               # システム設定

---

⚠️ 重要なリスク警告

取引リスク

1. 暗号通貨市場は非常にボラティルが高い、AI判断は利益を保証しません
2. 先物取引はレバレッジを使用、損失が元本を超える可能性があります
3. 極端な市場状況は清算リスクにつながる可能性があります
4. ファンディングレートは保有コストに影響する可能性があります
5. 流動性リスク: 一部のコインでスリッページが発生する可能性があります

技術リスク

1. ネットワークレイテンシは価格スリッページを引き起こす可能性があります
2. APIレート制限は取引実行に影響する可能性があります
3. AI APIタイムアウトは判断失敗を引き起こす可能性があります
4. システムバグは予期しない動作を引き起こす可能性があります

使用推奨事項

✅ 推奨

• テストには失っても構わない資金のみを使用
• 少額から始める（推奨100-500 USDT）
• システムの動作状態を定期的に確認
• アカウント残高の変化を監視
• AI判断ログを分析して戦略を理解

❌ 非推奨

• すべての資金または借りたお金を投資
• 長期間監視なしで実行
• AI判断を盲目的に信頼
• システムを理解せずに使用
• 極端な市場ボラティリティ中に実行

---

🛠️ よくある問題

1. コンパイルエラー：TA-Libが見つからない

解決策: TA-Libライブラリをインストール

# macOS
brew install ta-lib

# Ubuntu
sudo apt-get install libta-lib0-dev

2. 精度エラー：Precision is over the maximum

解決策: システムがBinance LOT_SIZEから精度を自動処理します。エラーが続く場合は、ネットワーク接続を確認してください。

3. AI APIタイムアウト

解決策:

• APIキーが正しいか確認
• ネットワーク接続を確認（プロキシが必要な場合があります）
• システムタイムアウトは120秒に設定されています

4. フロントエンドがバックエンドに接続できない

解決策:

• バックエンドが実行中であることを確認（http://localhost:8080）
• ポート8080が占有されていないか確認
• ブラウザコンソールでエラーを確認

5. コインプールAPI失敗

解決策:

• コインプールAPIはオプションです
• APIが失敗した場合、システムはデフォルトのメインストリームコイン（BTC、ETHなど）を使用
• config.jsonのAPI URLと認証パラメータを確認

---

📈 パフォーマンス最適化のヒント

1. 合理的な判断サイクルを設定: 3-5分を推奨、過剰取引を避ける
2. 候補コイン数を制御: システムはデフォルトでAI500上位20 + OI Top上位20
3. ログを定期的にクリーン: 過度なディスク使用を避ける
4. API呼び出し数を監視: Binanceレート制限のトリガーを避ける
5. 少額資本でテスト: まず100-500 USDTで戦略検証をテスト

---

🔄 変更履歴

v2.0.2（2025-10-29）

重大なバグ修正 - 取引履歴とパフォーマンス分析：

このバージョンは、収益性統計に大きく影響した過去取引記録とパフォーマンス分析システムの重大な計算エラーを修正します。

1. PnL計算 - 主要エラー修正（logger/decision_logger.go）

• 問題: 以前はパーセンテージのみで計算され、ポジションサイズとレバレッジを完全に無視
  • 例：100 USDTポジションが5%獲得と1000 USDTポジションが5%獲得の両方が利益として5.0と表示
  • これによりパフォーマンス分析が完全に不正確に
• 解決策: 実際のUSDT利益額を計算

  PnL（USDT）= ポジション価値 × 価格変化% × レバレッジ
  例：1000 USDT × 5% × 20x = 1000 USDT実際の利益
  

• 影響: 勝率、利益率、シャープレシオが正確なUSDT額に基づくようになりました

2. ポジション追跡 - 重要データの欠落

• 問題: オープンポジション記録が価格と時間のみを保存、数量とレバレッジが欠落
• 解決策: 完全な取引データを保存：
  • quantity: ポジションサイズ（コイン単位）
  • leverage: レバレッジ倍率（例：20x）
  • これらは正確なPnL計算に不可欠

3. ポジションキーロジック - ロング/ショート競合

• 問題: symbolをポジションキーとして使用し、ロングとショートの両方を保有する際にデータ競合を引き起こす
  • 例：BTCUSDTロングとBTCUSDTショートが互いに上書き
• 解決策: symbol_side形式に変更（例：BTCUSDT_long、BTCUSDT_short）
  • ロングとショートポジションを適切に区別

4. シャープレシオ計算 - コード最適化

• 問題: 平方根計算にカスタムニュートン法を使用
• 解決策: 標準ライブラリmath.Sqrtに置き換え
  • より信頼性が高く、保守可能で効率的

このアップデートが重要な理由：

• ✅ 過去取引統計が無意味なパーセンテージではなく実際のUSDT損益を表示
• ✅ 異なるレバレッジ取引間のパフォーマンス比較が正確に
• ✅ AI自己学習メカニズムが正しい過去フィードバックを受信
• ✅ 利益率とシャープレシオの計算が意味を持つように
• ✅ マルチポジション追跡（ロング + ショート同時）が正しく機能

推奨: このアップデート前にシステムを実行していた場合、過去統計は不正確でした。v2.0.2にアップデート後、新しい取引は正しく計算されます。

v2.0.2（2025-10-29）

バグ修正：

• ✅ Aster取引所精度エラーを修正（コード-1111：「Precision is over the maximum defined for this asset」）
• ✅ 取引所の精度要件に合わせて価格と数量のフォーマットを改善
• ✅ デバッグ用の詳細な精度処理ログを追加
• ✅ 適切な精度処理ですべての注文関数（OpenLong、OpenShort、CloseLong、CloseShort、SetStopLoss、SetTakeProfit）を強化

技術詳細：

• float64を正しい精度で文字列に変換するformatFloatWithPrecision関数を追加
• 価格と数量パラメータが取引所のpricePrecisionとquantityPrecision仕様に従ってフォーマットされるようになりました
• API リクエストを最適化するために、フォーマットされた値から末尾のゼロを削除

v2.0.1（2025-10-29）

バグ修正：

• ✅ ComparisonChartデータ処理ロジックを修正 - cycle_numberからタイムスタンプグループ化に切り替え
• ✅ バックエンド再起動時にcycle_numberがリセットされるとチャートがフリーズする問題を解決
• ✅ チャートデータ表示を改善 - すべての過去データポイントを時系列で表示
• ✅ トラブルシューティングを改善するためのデバッグログを強化

v2.0.0（2025-10-28）

主要アップデート：

• ✅ AI自己学習メカニズム（過去フィードバック、パフォーマンス分析）
• ✅ マルチトレーダー競争モード（Qwen対DeepSeek）
• ✅ BinanceスタイルUI（完全なBinanceインターフェース模倣）
• ✅ パフォーマンス比較チャート（リアルタイムROI比較）
• ✅ リスク管理最適化（コインごとのポジション制限調整）

バグ修正：

• 初期残高のハードコーディング問題を修正
• マルチトレーダーデータ同期問題を修正
• チャートデータの整列を最適化（cycle_numberを使用）

v1.0.0（2025-10-27）

• 初回リリース
• 基本的なAI取引機能
• 判断ログシステム
• シンプルなWebインターフェース

---

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください

---

🤝 貢献

IssueとPull Requestを歓迎します！

開発ガイド

1. プロジェクトをフォーク
2. 機能ブランチを作成（git checkout -b feature/AmazingFeature）
3. 変更をコミット（git commit -m 'Add some AmazingFeature'）
4. ブランチにプッシュ（git push origin feature/AmazingFeature）
5. Pull Requestを開く

---

📬 お問い合わせ

🐛 技術サポート

• GitHub Issues: Issueを提出
• 開発者コミュニティ: Telegramグループ

---

🙏 謝辞

• Binance API - Binance先物API
• DeepSeek - DeepSeek AI API
• Qwen - Alibaba Cloud Qwen
• TA-Lib - テクニカル指標ライブラリ
• Recharts - Reactチャートライブラリ

---

最終更新: 2025-10-29（v2.0.3）

⚡ AIの力で量的取引の可能性を探求しましょう！

---

⭐ Star履歴