╔══════════════════════════════════════════════════════════════╗

║ AI US500 PRO ║

║ Hybrid Trend / Mean-Reversion cBot ║

║ Multi-AI • Multi-Timeframe ║

╚══════════════════════════════════════════════════════════════╝

🧠 **AI US500 PRO** adalah cBot profesional untuk cTrader yang direka khusus untuk indeks S&P 500 (US500). Ia menggabungkan analisis teknikal berbilang jangka masa dengan kecerdasan buatan untuk menapis setiap perdagangan sebelum pelaksanaan.

Bot ini beroperasi merentasi **3 jangka masa serentak** (H4 → H1 → M15), secara automatik mengesan rejim pasaran (tren atau julat) dan menggunakan strategi yang paling sesuai: mengikuti tren apabila pasaran mempunyai arah, mean-reversion apabila ia bergerak secara mendatar. Setiap isyarat yang dijana boleh disahkan secara masa nyata oleh model AI pilihan anda daripada **13 penyedia yang disokong**.

Berjalan dengan `AccessRights.None` — tiada kebenaran khas diperlukan, menggunakan API HTTP asli cTrader.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📐 **SENIBINA STRATEGI**

Bot mengikuti aliran keputusan bertingkat:

```

H4 (EMA 200) → Menentukan bias arah jangka panjang (bullish / bearish / neutral)

↓

H1 (EMA 50 + RSI 14) → Mengesahkan arah dan menilai keterlaluan

↓

M15 (EMA 21/50 + Stoch + BB + ADX + ATR) → Menjana isyarat masuk

↓

AI (Claude / GPT / Gemini / ...) → Menapis isyarat dengan skor keyakinan

↓

Pelaksanaan → Pengiraan volum, SL/TP dinamik, trailing stop

```

⚡ **Pengesanan Rejim (ADX)**

— ADX ≥ ambang → pasaran tren → strategi mengikuti tren

— ADX < ambang → pasaran julat → strategi mean-reversion

Peralihan adalah sepenuhnya automatik, bar demi bar.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 **STRATEGI MENGIKUTI TREN**

Syarat masuk LONG:

✅ H4: harga di atas EMA 200 (bias bullish)

✅ H1: harga di atas EMA 50 + RSI > 50

✅ M15: EMA 21 melintasi di atas EMA 50 (crossover bullish)

✅ M15: Stochastic K melintasi di atas D, dengan K < 65 (tidak terlebih beli)

Syarat masuk SHORT: cermin dan terbalik.

📊 **STRATEGI MEAN-REVERSION**

Syarat masuk LONG:

✅ ADX di bawah ambang (pasaran julat)

✅ M15: harga menyentuh atau memecah Bollinger Band bawah

✅ M15: Stochastic K < 20 (terlebih jual)

✅ H1: RSI < 35 (keterlaluan bearish)

Syarat masuk SHORT: cermin dan terbalik.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🤖 **INTEGRASI AI — 13 PENYEDIA**

Apabila bot menjana isyarat teknikal yang sah, sebelum melaksanakan ia menghantar pakej data lengkap kepada AI yang mengandungi:

— Semua penunjuk berbilang jangka masa

— N lilin M15 terakhir (OHLCV)

— Arah yang dicadangkan dan strategi aktif

— Parameter risiko (SL/TP dalam pips, nisbah R:R)

— Status akaun dan posisi terbuka

AI membalas dengan:

— **Skor keyakinan** (0-100%)

— **Keputusan** (GO / NO_GO)

— **Faktor utama** (2-3 faktor utama)

— **Amaran risiko** (risiko utama yang dikenal pasti)

Jika keyakinan jatuh di bawah ambang minimum, perdagangan akan **diblok**.

Selepas setiap perdagangan ditutup, AI juga menyediakan **analisis pasca-perdagangan** dengan penilaian, penarafan dan pengajaran yang diperoleh.

**Penyedia yang disokong:**

```

1. Anthropic (Claude) — claude-sonnet-4

2. OpenAI (ChatGPT) — gpt-4o

3. Google (Gemini) — gemini-2.0-flash

4. Mistral — mistral-large-latest

5. Groq — llama-3.3-70b-versatile

6. Perplexity — sonar-pro

7. Cohere — command-r-plus

8. xAI (Grok) — grok-2

9. DeepSeek — deepseek-chat

10. Together AI — Llama-3.3-70B-Instruct-Turbo

11. Fireworks AI — llama-v3p3-70b-instruct

12. OpenRouter — anthropic/claude-sonnet-4

13. Ollama (tempatan, percuma) — llama3.1

```

Setiap penyedia mempunyai URL dan model lalai yang telah dikonfigurasikan. Anda boleh menukar kedua-dua model dan URL untuk fleksibiliti maksimum.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔧 **PARAMETER — PANDUAN LENGKAP**

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💰 **1. PENGURUSAN RISIKO**

▸ **Mod Risiko** — `PercentRisk` / `FixedLot`

Pilih antara saiz posisi berdasarkan peratusan atau lot tetap. Dalam mod PercentRisk, bot secara automatik mengira volum berdasarkan jarak stop loss dan modal tersedia. Lalai: `PercentRisk`

▸ **Peratus Risiko per Perdagangan** — 0.1% hingga 5.0%

Peratus baki akaun yang dipertaruhkan pada setiap perdagangan. Volum dikira supaya jika SL terkena, kerugian adalah tepat peratus ini. Lalai: `1.0%`

▸ **Volum Tetap (Lot)** — 0.01 dan ke atas

Volum tetap dalam lot, hanya digunakan apabila Mod Risiko ditetapkan kepada FixedLot. Lalai: `0.1`

▸ **Maks Posisi Terbuka** — 1 hingga 10

Bilangan maksimum posisi yang boleh dipegang serentak oleh bot. Apabila had dicapai, tiada perdagangan baru dibuka. Lalai: `3`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📈 **2. BIAS TREN H4**

▸ **Tempoh EMA H4** — 50 dan ke atas

Tempoh EMA yang digunakan pada jangka masa H4. Menentukan bias arah jangka panjang. Harga di atas EMA = bias bullish, di bawah = bearish. Penampan berasaskan ATR mengelakkan isyarat palsu apabila harga terlalu dekat dengan purata. Lalai: `200`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔍 **3. PENGESAHAN H1**

▸ **Tempoh EMA H1** — 10 dan ke atas

Tempoh EMA pada jangka masa H1. Harga mesti berada di sisi EMA yang betul untuk mengesahkan kemasukan. Lalai: `50`

▸ **Tempoh RSI H1** — 5 dan ke atas

Tempoh Indeks Kekuatan Relatif pada H1. Digunakan untuk pengesahan tren (RSI > 50 untuk long, < 50 untuk short) dan penapisan keterlaluan dalam mean-reversion (RSI < 35 atau > 65). Lalai: `14`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯 **4. MASUK M15**

▸ **Tempoh EMA Pantas** — 5 dan ke atas

EMA pantas pada jangka masa masuk (M15). Crossover dengan EMA perlahan menjana isyarat mengikuti tren. Lalai: `21`

▸ **Tempoh EMA Perlahan** — 10 dan ke atas

EMA perlahan. Crossover EMA Pantas/Perlahan adalah pencetus utama untuk strategi tren. Lalai: `50`

▸ **Stochastic K / D / Slowing** — tempoh osilator stochastic

Digunakan sebagai pengesahan momentum. Dalam strategi tren ia menapis kemasukan di zon tidak ekstrem; dalam mean-reversion ia mengenal pasti kawasan terlebih beli/terlebih jual. Lalai: `K=14, D=3, Slowing=3`

▸ **Tempoh Bollinger** — 10 dan ke atas

Tempoh Bollinger Bands. Dalam mean-reversion, sentuhan pada jalur atas/bawah adalah pencetus masuk. Lalai: `20`

▸ **Sisihan Piawai Bollinger** — 1.0 dan ke atas

Sisihan piawai jalur. Nilai lebih tinggi = jalur lebih lebar = isyarat kurang tetapi lebih boleh dipercayai. Lalai: `2.0`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🌡️ **5. PENGESANAN REJIM (ADX)**

▸ **Tempoh ADX** — 7 dan ke atas

Tempoh Sistem Pergerakan Arah. Mengukur kekuatan tren tanpa mengira arah. Lalai: `14`

▸ **Ambang Tren ADX** — 15 hingga 40

Ambang yang memisahkan pasaran tren dan julat. ADX di atas nilai ini = strategi mengikuti tren aktif; di bawah = strategi mean-reversion aktif. Lalai: `25`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛡️ **6. SL / TP (BERASASKAN ATR)**

Semua stop loss dan take profit adalah dinamik, dikira sebagai gandaan ATR semasa. Ini bermakna ia menyesuaikan secara automatik dengan volatiliti: stop ketat dalam pasaran tenang, stop lebih luas dalam pasaran volatil.

▸ **Tempoh ATR** — 5 dan ke atas

Tempoh Purata Julat Benar. Mengukur volatiliti terkini dan menjadi asas untuk pengiraan SL, TP, breakeven dan trailing. Lalai: `14`

▸ **SL x ATR** — 0.5 dan ke atas

Gandaan ATR untuk stop loss. Contoh: dengan ATR = 20 mata dan gandaan 1.5, SL akan berada 30 mata dari harga masuk. Lalai: `1.5`

▸ **TP x ATR (Tren)** — 1.0 dan ke atas

Gandaan ATR untuk take profit dalam strategi mengikuti tren. Biasanya lebih tinggi daripada SL untuk nisbah R:R yang menguntungkan. Lalai: `2.5`

▸ **TP x ATR (Reversion)** — 0.5 dan ke atas

Gandaan ATR untuk take profit dalam mean-reversion. Biasanya lebih konservatif kerana sasaran adalah kembali ke purata. Lalai: `1.5`

▸ **SL Min (Pips)** — 1 dan ke atas

Stop loss minimum dalam pips. Jika pengiraan ATR menghasilkan SL di bawah nilai ini, nilai minimum digunakan. Melindungi daripada stop terlalu ketat dalam keadaan volatiliti sangat rendah. Lalai: `10`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔄 **7. TRAILING STOP**

Sistem pengurusan aktif untuk posisi terbuka dengan breakeven automatik dan trailing stop, kedua-duanya berasaskan ATR.

▸ **Aktifkan Trailing** — Hidup/Mati

Mengaktifkan/mematikan keseluruhan sistem trailing. Apabila dimatikan, posisi mengekalkan SL/TP tetap sehingga ditutup. Lalai: `Hidup`

▸ **Breakeven Selepas x ATR** — 0.3 dan ke atas

Apabila keuntungan belum direalisasi mencapai gandaan ATR ini, SL dipindahkan ke harga masuk (+ separuh spread untuk menampung kos). Perdagangan menjadi tanpa risiko. Lalai: `1.0`

▸ **Jarak Trailing x ATR** — 0.5 dan ke atas

Jarak trailing stop dari harga semasa, dinyatakan sebagai gandaan ATR. SL mengikuti harga dan tidak pernah bergerak ke belakang. Lalai: `1.2`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🕐 **8. PENAPIS SESI**

Menapis aktiviti perdagangan berdasarkan masa. US500 berkelakuan sangat berbeza semasa pra-pasaran, sesi biasa dan selepas waktu.

▸ **Aktifkan Penapis Sesi** — Hidup/Mati

Mengaktifkan/mematikan penapis masa. Lalai: `Hidup`

▸ **Mula Sesi (Jam CET)** — 0-23

Jam mula tetingkap perdagangan (zon waktu CET). Lalai: `15` (buka sesi AS)

▸ **Tamat Sesi (Jam CET)** — 0-23

Jam tamat tetingkap perdagangan. Lalai: `22` (tutup sesi AS)

Bot juga menyokong sesi yang melintasi tengah malam (contoh: Mula=22, Tamat=6).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ **9. PELBAGAI**

▸ **Cooldown (Bar)** — 0 dan ke atas

Bilangan minimum bar M15 yang mesti berlalu antara satu perdagangan dan seterusnya. Mencegah overtrading dalam situasi isyarat pantas. Lalai: `3` (= 45 minit)

▸ **Tunjukkan Papan Pemuka** — Hidup/Mati

Menunjukkan/menyembunyikan papan pemuka pada carta dengan rejim, bias, penunjuk, P&L, status AI dan statistik langsung. Lalai: `Hidup`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🤖 **10. ANALISIS AI**

▸ **Aktifkan Penapis AI** — Hidup/Mati

Mengaktifkan/mematikan penapis AI. Apabila dimatikan, bot beroperasi hanya berdasarkan analisis teknikal. Lalai: `Mati`

▸ **Penyedia AI** — pilihan antara 13 penyedia

Pilih penyedia AI yang akan digunakan. Setiap penyedia mempunyai URL dan model lalai yang telah dikonfigurasikan. Lalai: `Anthropic`

▸ **Kunci API** — rentetan

Kunci API anda untuk penyedia yang dipilih. Diperlukan untuk semua penyedia kecuali Ollama (yang berjalan secara tempatan). Biarkan kosong jika menggunakan Ollama.

▸ **Model (kosong=lalai)** — rentetan

Tindakan ganti model AI. Biarkan kosong untuk menggunakan model lalai penyedia yang dipilih. Berguna untuk menguji model tertentu (contoh: "gpt-4o-mini", "claude-haiku-4-5-20251001").

▸ **URL API Tersuai (kosong=lalai)** — rentetan

Tindakan ganti URL API. Berguna untuk Ollama pada port tersuai, proksi korporat atau titik akhir tersuai.

▸ **Keyakinan Min (%)** — 30 hingga 95

Ambang keyakinan AI minimum untuk meluluskan perdagangan. Jika AI mengembalikan skor di bawah ini, perdagangan diblok walaupun semua isyarat teknikal sah. Lalai: `65`

▸ **Fail Open (benarkan jika ralat)** — Hidup/Mati

Tingkah laku apabila AI gagal (masa tamat, API turun, respons tidak sah). Hidup = perdagangan tetap diteruskan (fail-open). Mati = perdagangan diblok (fail-closed). Lalai: `Hidup`

▸ **Ulasan AI Pasca-Perdagangan** — Hidup/Mati

Apabila diaktifkan, selepas setiap perdagangan ditutup bot menghantar butiran keputusan kepada AI yang menyediakan penilaian, penarafan (BAIK/NETRAL/BURUK) dan pengajaran yang diperoleh. Semua direkodkan ke konsol. Lalai: `Hidup`

▸ **Bar Harga ke AI** — 5 hingga 25

Bilangan lilin M15 terkini yang dihantar kepada AI dalam konteks analisis. Lebih banyak bar = lebih banyak konteks tetapi lebih banyak token digunakan. Lalai: `12`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 **PAPAN PEMUKA PADA CARTA**

Papan pemuka memaparkan secara masa nyata:

— Rejim semasa (TREND / RANGE)

— Bias H4 (BULL / BEAR / FLAT)

— Nilai ADX, ATR, RSI H1

— Posisi terbuka / maksimum

— P&L terbuka, baki, ekuiti

— Status sesi (AKTIF / TUTUP)

— Jumlah perdagangan dan peratusan kemenangan

— Status AI: penyedia, keputusan terakhir, keyakinan

— Kiraan panggilan AI dan perdagangan yang diblok

Warna berubah secara automatik: 🟢 hijau apabila P&L positif, 🔴 merah apabila negatif.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📌 **NOTA TEKNIKAL**

— Jangka masa yang disyorkan: **M15** (bot memberi amaran jika digunakan pada TF lain)

— `AccessRights.None` — tiada kebenaran khas diperlukan

— Menggunakan `Http.Send()` asli cTrader untuk panggilan AI

— Serasi dengan cTrader 4.2+ (.NET 6)

— Menyokong backtesting (tanpa AI) dan perdagangan langsung (dengan atau tanpa AI)

— Posisi bot dikenali dengan label `AiUS500Pro`

— Tidak mengganggu posisi manual atau bot lain

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️ **PENAFIAN**

cBot ini disediakan untuk tujuan pendidikan dan maklumat sahaja. Perdagangan indeks melibatkan risiko kehilangan modal yang ketara. Keputusan lalu tidak menjamin pulangan masa depan. Integrasi AI meningkatkan penapisan tetapi tidak menghapuskan risiko. Sentiasa uji pada akaun demo sebelum menggunakan pada akaun langsung. Anda bertanggungjawab sepenuhnya atas keputusan perdagangan anda.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━