From b145c4e2f61016658baccdbf8c35128c00cfa774 Mon Sep 17 00:00:00 2001
From: PorunC <09982.misaka@gmail.com>
Date: Wed, 29 Oct 2025 20:34:43 +0800
Subject: [PATCH] =?UTF-8?q?Docs:=20Sync=20leverage=20configuration=20guide?=
 =?UTF-8?q?=20to=20all=20language=20versions=20-=20Update=20Chinese=20(REA?=
 =?UTF-8?q?DME.zh-CN.md)=20with=20leverage=20configuration=20documentation?=
 =?UTF-8?q?=20-=20Update=20Russian=20(README.ru.md)=20with=20leverage=20co?=
 =?UTF-8?q?nfiguration=20documentation=20-=20Update=20Ukrainian=20(README.?=
 =?UTF-8?q?uk.md)=20with=20leverage=20configuration=20documentation=20All?=
 =?UTF-8?q?=20language=20versions=20now=20include:=20-=20Updated=20risk=20?=
 =?UTF-8?q?management=20section=20(fixed=20=E2=86=92=20configurable=20leve?=
 =?UTF-8?q?rage)=20-=20Leverage=20configuration=20in=20JSON=20examples=20-?=
 =?UTF-8?q?=20New=20leverage=20fields=20in=20configuration=20tables=20-=20?=
 =?UTF-8?q?Comprehensive=20leverage=20configuration=20section=20with:=20?=
 =?UTF-8?q?=20=20-=20Configuration=20format=20and=20examples=20=20=20-=20B?=
 =?UTF-8?q?inance=20subaccount=20restriction=20warnings=20(=E2=89=A45x)=20?=
 =?UTF-8?q?=20=20-=20Recommended=20settings=20for=20different=20account=20?=
 =?UTF-8?q?types=20=20=20-=20Safe=20and=20aggressive=20configuration=20exa?=
 =?UTF-8?q?mples=20=20=20-=20Explanation=20of=20AI=20leverage=20usage=20Th?=
 =?UTF-8?q?is=20ensures=20all=20users=20can=20read=20the=20leverage=20docu?=
 =?UTF-8?q?mentation=20in=20their=20preferred=20language.=20Co-Authored-By?=
 =?UTF-8?q?:=20tinkle-community=20<tinklefund@gmail.com>?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.ru.md    | 70 ++++++++++++++++++++++++++++++++++++++++++++++++-
 README.uk.md    | 70 ++++++++++++++++++++++++++++++++++++++++++++++++-
 README.zh-CN.md | 70 ++++++++++++++++++++++++++++++++++++++++++++++++-
 3 files changed, 207 insertions(+), 3 deletions(-)

diff --git a/README.ru.md b/README.ru.md
index f9737148..9febe179 100644
--- a/README.ru.md
+++ b/README.ru.md
@@ -50,7 +50,11 @@
 - **Лимит позиции по монете**:
   - Альткоины ≤ 1.5x капитал счета
   - BTC/ETH ≤ 10x капитал счета
-- **Фиксированное плечо**: Альткоины 20x | BTC/ETH 50x
+- **Настраиваемое плечо** (v2.0.3+):
+  - Установите максимальное плечо в config.json
+  - По умолчанию: 5x для всех монет (безопасно для субаккаунтов)
+  - Основные аккаунты могут увеличить: Альткоины до 20x, BTC/ETH до 50x
+  - ⚠️ Субаккаунты Binance ограничены ≤5x плечом
 - **Управление маржой**: Общее использование ≤90%, AI принимает автономные решения
 - **Соотношение риск/доход**: Обязательное ≥1:2 (стоп-лосс:тейк-профит)
 - **Предотвращение накопления позиций**: Запрет дублирования открытия той же монеты/направления
@@ -268,6 +272,10 @@ cp config.json.example config.json
       "scan_interval_minutes": 3
     }
   ],
+  "leverage": {
+    "btc_eth_leverage": 5,
+    "altcoin_leverage": 5
+  },
   "use_default_coins": true,
   "coin_pool_api_url": "",
   "oi_top_api_url": "",
@@ -360,6 +368,9 @@ cp config.json.example config.json
 | `qwen_key` | Qwen API ключ | `"sk-xxx"` | Требуется при использовании Qwen |
 | `initial_balance` | Начальный баланс для расчета P/L | `1000.0` | ✅ Да |
 | `scan_interval_minutes` | Частота решений (минуты) | `3` (рекомендуется 3-5) | ✅ Да |
+| **`leverage`** | **Конфигурация плеча (v2.0.3+)** | См. ниже | ✅ Да |
+| `btc_eth_leverage` | Максимальное плечо для BTC/ETH<br>⚠️ Субаккаунты: ≤5x | `5` (по умолчанию, безопасно)<br>`50` (максимум для основного аккаунта) | ✅ Да |
+| `altcoin_leverage` | Максимальное плечо для альткоинов<br>⚠️ Субаккаунты: ≤5x | `5` (по умолчанию, безопасно)<br>`20` (максимум для основного аккаунта) | ✅ Да |
 | `use_default_coins` | Использовать встроенный список монет<br>**✨ Умное значение по умолчанию: `true`** (v2.0.2+)<br>Автоматически включается без API | `true` или опустить | ❌ Нет<br>(Опционально, авто) |
 | `coin_pool_api_url` | API пользовательского пула монет<br>*Требуется только при `use_default_coins: false`* | `""` (пусто) | ❌ Нет |
 | `oi_top_api_url` | API открытого интереса<br>*Опциональные дополнительные данные* | `""` (пусто) | ❌ Нет |
@@ -370,6 +381,63 @@ cp config.json.example config.json
 
 ---
 
+#### ⚙️ Конфигурация плеча (v2.0.3+)
+
+**Что такое конфигурация плеча?**
+
+Настройки плеча контролируют максимальное плечо, которое AI может использовать для каждой сделки. Это критически важно для управления рисками, особенно для субаккаунтов Binance, которые имеют ограничения по плечу.
+
+**Формат конфигурации:**
+
+```json
+"leverage": {
+  "btc_eth_leverage": 5,    // Максимальное плечо для BTC и ETH
+  "altcoin_leverage": 5      // Максимальное плечо для всех других монет
+}
+```
+
+**⚠️ Важно: Ограничения субаккаунтов Binance**
+
+- **Субаккаунты**: Ограничены **≤5x плечом** от Binance
+- **Основные аккаунты**: Могут использовать до 20x (альткоины) или 50x (BTC/ETH)
+- Если вы используете субаккаунт и установите плечо >5x, сделки будут **завершаться с ошибкой**: `Subaccounts are restricted from using leverage greater than 5x`
+
+**Рекомендуемые настройки:**
+
+| Тип аккаунта | Плечо BTC/ETH | Плечо альткоинов | Уровень риска |
+|--------------|---------------|------------------|---------------|
+| **Субаккаунт** | `5` | `5` | ✅ Безопасно (по умолчанию) |
+| **Основной (Консервативно)** | `10` | `10` | 🟡 Средний |
+| **Основной (Агрессивно)** | `20` | `15` | 🔴 Высокий |
+| **Основной (Максимум)** | `50` | `20` | 🔴🔴 Очень высокий |
+
+**Примеры:**
+
+**Безопасная конфигурация (субаккаунт или консервативная):**
+```json
+"leverage": {
+  "btc_eth_leverage": 5,
+  "altcoin_leverage": 5
+}
+```
+
+**Агрессивная конфигурация (только основной аккаунт):**
+```json
+"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+):**
diff --git a/README.uk.md b/README.uk.md
index 7af93d25..b5afe3fb 100644
--- a/README.uk.md
+++ b/README.uk.md
@@ -50,7 +50,11 @@
 - **Ліміт позиції по монеті**:
   - Альткоїни ≤ 1.5x капітал рахунку
   - BTC/ETH ≤ 10x капітал рахунку
-- **Фіксоване плече**: Альткоїни 20x | BTC/ETH 50x
+- **Налаштовуване плече** (v2.0.3+):
+  - Встановіть максимальне плече в config.json
+  - За замовчуванням: 5x для всіх монет (безпечно для субакаунтів)
+  - Основні акаунти можуть збільшити: Альткоїни до 20x, BTC/ETH до 50x
+  - ⚠️ Субакаунти Binance обмежені ≤5x плечем
 - **Управління маржею**: Загальне використання ≤90%, AI приймає автономні рішення
 - **Співвідношення ризик/дохід**: Обов'язкове ≥1:2 (стоп-лосс:тейк-профіт)
 - **Запобігання накопиченню позицій**: Заборона дублювання відкриття тієї ж монети/напрямку
@@ -268,6 +272,10 @@ cp config.json.example config.json
       "scan_interval_minutes": 3
     }
   ],
+  "leverage": {
+    "btc_eth_leverage": 5,
+    "altcoin_leverage": 5
+  },
   "use_default_coins": true,
   "coin_pool_api_url": "",
   "oi_top_api_url": "",
@@ -360,6 +368,9 @@ cp config.json.example config.json
 | `qwen_key` | Qwen API ключ | `"sk-xxx"` | Потрібно при використанні Qwen |
 | `initial_balance` | Початковий баланс для розрахунку P/L | `1000.0` | ✅ Так |
 | `scan_interval_minutes` | Частота рішень (хвилини) | `3` (рекомендується 3-5) | ✅ Так |
+| **`leverage`** | **Конфігурація плеча (v2.0.3+)** | Див. нижче | ✅ Так |
+| `btc_eth_leverage` | Максимальне плече для BTC/ETH<br>⚠️ Субакаунти: ≤5x | `5` (за замовчуванням, безпечно)<br>`50` (максимум для основного акаунта) | ✅ Так |
+| `altcoin_leverage` | Максимальне плече для альткоїнів<br>⚠️ Субакаунти: ≤5x | `5` (за замовчуванням, безпечно)<br>`20` (максимум для основного акаунта) | ✅ Так |
 | `use_default_coins` | Використовувати вбудований список монет<br>**✨ Розумне значення за замовчуванням: `true`** (v2.0.2+)<br>Автоматично включається без API | `true` або опустити | ❌ Ні<br>(Опціонально, авто) |
 | `coin_pool_api_url` | API користувацького пулу монет<br>*Потрібно лише при `use_default_coins: false`* | `""` (пусто) | ❌ Ні |
 | `oi_top_api_url` | API відкритого інтересу<br>*Опціональні додаткові дані* | `""` (пусто) | ❌ Ні |
@@ -370,6 +381,63 @@ cp config.json.example config.json
 
 ---
 
+#### ⚙️ Конфігурація плеча (v2.0.3+)
+
+**Що таке конфігурація плеча?**
+
+Налаштування плеча контролюють максимальне плече, яке AI може використовувати для кожної угоди. Це критично важливо для управління ризиками, особливо для субакаунтів Binance, які мають обмеження по плечу.
+
+**Формат конфігурації:**
+
+```json
+"leverage": {
+  "btc_eth_leverage": 5,    // Максимальне плече для BTC та ETH
+  "altcoin_leverage": 5      // Максимальне плече для всіх інших монет
+}
+```
+
+**⚠️ Важливо: Обмеження субакаунтів Binance**
+
+- **Субакаунти**: Обмежені **≤5x плечем** від Binance
+- **Основні акаунти**: Можуть використовувати до 20x (альткоїни) або 50x (BTC/ETH)
+- Якщо ви використовуєте субакаунт і встановите плече >5x, угоди будуть **завершуватися з помилкою**: `Subaccounts are restricted from using leverage greater than 5x`
+
+**Рекомендовані налаштування:**
+
+| Тип акаунта | Плече BTC/ETH | Плече альткоїнів | Рівень ризику |
+|-------------|---------------|------------------|---------------|
+| **Субакаунт** | `5` | `5` | ✅ Безпечно (за замовчуванням) |
+| **Основний (Консервативно)** | `10` | `10` | 🟡 Середній |
+| **Основний (Агресивно)** | `20` | `15` | 🔴 Високий |
+| **Основний (Максимум)** | `50` | `20` | 🔴🔴 Дуже високий |
+
+**Приклади:**
+
+**Безпечна конфігурація (субакаунт або консервативна):**
+```json
+"leverage": {
+  "btc_eth_leverage": 5,
+  "altcoin_leverage": 5
+}
+```
+
+**Агресивна конфігурація (тільки основний акаунт):**
+```json
+"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+):**
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 66b4979e..4fbabdde 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -50,7 +50,11 @@
 - **单币种仓位上限**:
   - 山寨币 ≤ 1.5倍账户净值
   - BTC/ETH ≤ 10倍账户净值
-- **固定杠杆**: 山寨币20倍 | BTC/ETH 50倍
+- **可配置杠杆** (v2.0.3+):
+  - 在config.json中设置最大杠杆
+  - 默认：所有币种5倍（子账户安全）
+  - 主账户可增加：山寨币最高20倍，BTC/ETH最高50倍
+  - ⚠️ 币安子账户限制≤5倍杠杆
 - **保证金管理**: 总使用率≤90%，AI自主决策使用率
 - **风险回报比**: 强制≥1:2（止损:止盈）
 - **防止仓位叠加**: 同币种同方向不允许重复开仓
@@ -331,6 +335,10 @@ cp config.json.example config.json
       "scan_interval_minutes": 3
     }
   ],
+  "leverage": {
+    "btc_eth_leverage": 5,
+    "altcoin_leverage": 5
+  },
   "use_default_coins": true,
   "coin_pool_api_url": "",
   "oi_top_api_url": "",
@@ -423,6 +431,9 @@ cp config.json.example config.json
 | `qwen_key` | Qwen API密钥 | `"sk-xxx"` | 使用Qwen时必填 |
 | `initial_balance` | 用于P/L计算的起始余额 | `1000.0` | ✅ 是 |
 | `scan_interval_minutes` | 决策频率（分钟） | `3`（建议3-5） | ✅ 是 |
+| **`leverage`** | **杠杆配置 (v2.0.3+)** | 见下文 | ✅ 是 |
+| `btc_eth_leverage` | BTC/ETH最大杠杆<br>⚠️ 子账户：≤5倍 | `5`（默认，安全）<br>`50`（主账户最大） | ✅ 是 |
+| `altcoin_leverage` | 山寨币最大杠杆<br>⚠️ 子账户：≤5倍 | `5`（默认，安全）<br>`20`（主账户最大） | ✅ 是 |
 | `use_default_coins` | 使用内置币种列表<br>**✨ 智能默认：`true`** (v2.0.2+)<br>未提供API时自动启用 | `true` 或省略 | ❌ 否<br>(可选，自动默认) |
 | `coin_pool_api_url` | 自定义币种池API<br>*仅当`use_default_coins: false`时需要* | `""`（空） | ❌ 否 |
 | `oi_top_api_url` | 持仓量API<br>*可选补充数据* | `""`（空） | ❌ 否 |
@@ -433,6 +444,63 @@ cp config.json.example config.json
 
 ---
 
+#### ⚙️ 杠杆配置 (v2.0.3+)
+
+**什么是杠杆配置？**
+
+杠杆设置控制AI每次交易可以使用的最大杠杆。这对于风险管理至关重要，特别是对于有杠杆限制的币安子账户。
+
+**配置格式：**
+
+```json
+"leverage": {
+  "btc_eth_leverage": 5,    // BTC和ETH的最大杠杆
+  "altcoin_leverage": 5      // 所有其他币种的最大杠杆
+}
+```
+
+**⚠️ 重要：币安子账户限制**
+
+- **子账户**：币安限制为**≤5倍杠杆**
+- **主账户**：可使用最高20倍（山寨币）或50倍（BTC/ETH）
+- 如果您使用子账户并设置杠杆>5倍，交易将**失败**，错误信息：`Subaccounts are restricted from using leverage greater than 5x`
+
+**推荐设置：**
+
+| 账户类型 | BTC/ETH杠杆 | 山寨币杠杆 | 风险级别 |
+|---------|------------|-----------|---------|
+| **子账户** | `5` | `5` | ✅ 安全（默认） |
+| **主账户（保守）** | `10` | `10` | 🟡 中等 |
+| **主账户（激进）** | `20` | `15` | 🔴 高 |
+| **主账户（最大）** | `50` | `20` | 🔴🔴 非常高 |
+
+**示例：**
+
+**安全配置（子账户或保守）：**
+```json
+"leverage": {
+  "btc_eth_leverage": 5,
+  "altcoin_leverage": 5
+}
+```
+
+**激进配置（仅主账户）：**
+```json
+"leverage": {
+  "btc_eth_leverage": 20,
+  "altcoin_leverage": 15
+}
+```
+
+**AI如何使用杠杆：**
+
+- AI可以选择**从1倍到您配置的最大值之间的任何杠杆**
+- 例如，当`altcoin_leverage: 20`时，AI可能根据市场情况决定使用5倍、10倍或20倍
+- 配置设置的是**上限**，而不是固定值
+- AI在选择杠杆时会考虑波动性、风险回报比和账户余额
+
+---
+
 #### ⚠️ 重要：`use_default_coins` 字段
 
 **智能默认行为（v2.0.2+）：**