Bot & Automation

Treding Forex Ai

/root/hermes-projects/Treding Forex Ai

docs/EXNESS_MT5_SETUP.md text
# Exness MT5 Setup

Exness automation sebaiknya dibuat lewat MetaTrader 5 karena akun Exness trading berjalan di platform MT4/MT5. Bot Telegram ini tidak menyimpan password Exness dan tidak langsung login ke broker.

## Data Yang Perlu Disiapkan

Jangan kirim password. Yang boleh dicatat di env:

- `EXNESS_ACCOUNT_TYPE`: `demo` atau `real`.
- `EXNESS_MT5_LOGIN`: nomor login MT5.
- `EXNESS_MT5_SERVER`: nama server MT5 dari Exness.
- `MT5_BRIDGE_URL`: URL private bridge yang berjalan di mesin yang sama dengan MT5.
- `MT5_BRIDGE_TOKEN`: token internal untuk bot ke bridge.

## Mode Aman Awal

Gunakan akun demo dulu:

```env
TRADING_MODE=paper
ENABLE_REAL_TRADING=false
BROKER_PROVIDER=disabled
EXNESS_ACCOUNT_TYPE=demo
```

## Bridge MT5

Untuk real execution, arsitektur yang disarankan:

```text
Telegram Bot
  -> Risk Manager
  -> MT5 Bridge HTTP private localhost
  -> MT5 Terminal / Expert Advisor
  -> Exness MT5 server
```

Bridge harus menyediakan endpoint:

```http
POST /orders
Authorization: Bearer <MT5_BRIDGE_TOKEN>
```

Body dari bot:

```json
{
  "clientOrderId": "uuid",
  "symbol": "XAUUSD",
  "side": "buy",
  "lotSize": 0.01,
  "entry": 2360.5,
  "stopLoss": 2355.5,
  "takeProfit": 2370.5
}
```

Response sukses:

```json
{
  "orderId": "mt5-ticket-id"
}
```

## Checklist Sebelum Real Trading

- Test minimal 1 minggu di demo.
- `MAX_DAILY_LOSS_PERCENT` kecil, misalnya 1 sampai 3.
- `RISK_PER_TRADE_PERCENT` maksimal 1 untuk awal.
- `MAX_OPEN_TRADES` maksimal 1 sampai 3.
- Pastikan VPS/terminal tidak menjalankan dua bot dengan token yang sama.
- Aktifkan real trading hanya setelah bridge diuji.

## Real Mode Env

Hanya setelah demo stabil:

```env
TRADING_MODE=semi_auto
ENABLE_REAL_TRADING=true
BROKER_PROVIDER=mt5_bridge
MT5_BRIDGE_URL=http://127.0.0.1:8095
MT5_BRIDGE_TOKEN=isi_secret_internal_bridge
EXNESS_ACCOUNT_TYPE=demo
EXNESS_MT5_LOGIN=isi_nomor_login_mt5
EXNESS_MT5_SERVER=isi_server_mt5_exness
```

Untuk akun real, ubah `EXNESS_ACCOUNT_TYPE=real` hanya setelah Anda siap menerima risiko penuh.

## Auto-Trading Gate

Bot sekarang punya scheduler auto-trading, tetapi real order tetap membutuhkan MT5 bridge/EA.

```env
AUTO_TRADING_ENABLED=true
AUTO_TRADE_SYMBOLS=XAUUSD
AUTO_TRADE_MODE=intraday
AUTO_SCAN_INTERVAL_SECONDS=300
AUTO_TRADE_COOLDOWN_MINUTES=60
AUTO_MIN_CONFIDENCE=70
```

Untuk akun real, gate wajib:

```env
TRADING_MODE=full_auto
ENABLE_REAL_TRADING=true
BROKER_PROVIDER=mt5_bridge
MT5_BRIDGE_URL=http://127.0.0.1:8095
MT5_BRIDGE_TOKEN=isi_secret_internal_bridge
```

Jika gate tersebut tidak lengkap, bot tetap berada di paper/guarded mode.