OtomatisasiΒ·

Cara Menambahkan Filter Berita ke Expert Advisor MT4 Anda

MetaTrader 4 tidak menyediakan kalender ekonomi untuk Expert Advisor. Panduan ini menambahkannya dalam sepuluh menit: API kalender gratis, satu file include, dan satu fungsi yang dipanggil sebelum setiap entry. Kode MQL4 lengkap, tanpa kunci API.

Expert Advisor yang tetap trading saat rilis Non-Farm Payrolls atau keputusan suku bunga sebenarnya sudah tidak menjalankan strateginya lagi: ia sedang melempar koin, dengan spread yang melebar pula. Filter berita mencegah hal itu. Entry baru dihentikan sementara beberapa menit sebelum dan sesudah rilis yang menggerakkan pasar, dan di luar jendela itu strategi dibiarkan bekerja seperti biasa.

MetaTrader 5 sudah punya kalender bawaan. MetaTrader 4 tidak, jadi EA harus mengambil data berita dari luar. Panduan ini memakai API kalender ekonomi ShowMyTrades yang gratis: tanpa akun, tanpa kunci API, cukup satu URL yang diizinkan di terminal dan satu file include yang bisa ditempelkan ke EA mana pun.

🧭 Apa yang Akan Anda Bangun

setiap 15 menit             setiap tick
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ unduh berita        β”‚ ──► β”‚ adakah rilis dalam rentang         β”‚
β”‚ 2 hari ke depan     β”‚     β”‚ [-30 mnt, +30 mnt] dari sekarang?  β”‚
β”‚ (CSV, 1 permintaan) β”‚     β”‚   ya    β†’ tidak ada entry baru     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β”‚   tidak β†’ jalankan strategi        β”‚
                            β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
KeputusanNilai bawaan di kodeAlasannya
Mata uang manaEUR,USDDua mata uang dari pair yang Anda perdagangkan. Jika dikosongkan, kesembilan mata uang mayor ikut disaring
Dampak manahighhigh,medium untuk filter yang lebih hati-hati
Jeda sebelum rilis30 menitMenjelang angka dirilis, spread melebar dan likuiditas menipis
Jeda sesudah rilis30 menitReaksi pertama pasar dan pembalikannya sama-sama terjadi di rentang ini
Interval unduhan15 menitKalender hanya berubah beberapa kali sehari; lagi pula API menyimpan cache selama 15 menit

πŸ”‘ Langkah 1: Izinkan Alamatnya di MetaTrader

WebRequest(), fungsi MQL4 untuk mengunduh data dari internet, hanya mau menghubungi alamat yang sudah Anda setujui. Di terminal, buka Tools β†’ Options β†’ Expert Advisors (Alat β†’ Opsi β†’ Expert Advisors), centang Allow WebRequest for listed URL (izinkan WebRequest untuk URL dalam daftar), lalu tambahkan:

https://showmytrades.com

Jika langkah ini dilewati, unduhan mengembalikan -1 dengan kode kesalahan 4060. Saat itu terjadi, file include menulis pengingat di tab Experts (log Expert Advisor), jadi Anda tidak perlu bertanya-tanya mengapa filternya diam saja.

πŸ“„ Langkah 2: Simpan File Include

Simpan kode berikut sebagai SMT_NewsFilter.mqh di folder MQL4\Include milik terminal; folder ini terbuka lewat File β†’ Open Data Folder (File β†’ Buka Folder Data). Isinya sama dengan file di referensi API (hanya komentarnya yang diterjemahkan), dan file ini juga bisa dikompilasi di MQL5 tanpa perubahan.

SMT_NewsFilter.mqh
//+------------------------------------------------------------------+
//| SMT_NewsFilter.mqh - filter berita untuk MT4 dan MT5             |
//| Data: https://showmytrades.com/api/public/calendar/v1 (gratis)   |
//| Panduan: https://showmytrades.com/docs/api/economic-calendar     |
//| Persiapan: Tools > Options > Expert Advisors >                   |
//|   Allow WebRequest for listed URL: https://showmytrades.com      |
//+------------------------------------------------------------------+
#property strict

input string SMT_Currencies     = "EUR,USD"; // Berita: mata uang (dipisah koma, kosong = semua)
input string SMT_Impact         = "high";    // Berita: dampak (high | high,medium | all)
input int    SMT_MinutesBefore  = 30;        // Berita: jeda sebelum rilis (menit)
input int    SMT_MinutesAfter   = 30;        // Berita: jeda setelah rilis (menit)
input int    SMT_RefreshMinutes = 15;        // Berita: interval unduhan (menit, min. 15)

datetime smt_eventTime[];
string   smt_eventTitle[];
datetime smt_nextDownload = 0;
long     smt_serverTime   = 0;     // waktu UTC server (detik Unix) saat unduhan terakhir
uint     smt_syncTick     = 0;     // GetTickCount() pada saat yang sama
bool     smt_clockSynced  = false;

//--- waktu UTC yang sebenarnya: jam server ditambah milidetik yang berlalu sejak
//--- unduhan, dihitung dengan GetTickCount(), yang tidak terpengaruh zona waktu, DST,
//--- maupun koreksi jam di komputer (pengurangan uint tetap benar saat nilainya berputar
//--- ulang dari nol). Sebelum unduhan pertama dipakai TimeGMT(). Jangan pernah TimeCurrent():
//--- offset GMT broker tidak diketahui dan bergeser saat pergantian DST.
datetime SMT_Now()
{
   if(!smt_clockSynced) return TimeGMT();
   uint elapsedMs = GetTickCount() - smt_syncTick;
   return (datetime)(smt_serverTime + elapsedMs / 1000);
}

//--- selisih jam broker dari UTC, dalam detik (7200 = GMT+2). Berguna juga secara
//--- tersendiri: kebanyakan EA tidak pernah tahu angka ini. TimeCurrent() adalah waktu
//--- tick terakhir, jadi baca nilai ini saat pasar buka, bukan saat akhir pekan.
int SMT_BrokerGmtOffsetSeconds()
{
   return (int)(TimeCurrent() - SMT_Now());
}

//--- semua teks setelah koma ke-n (judul di CSV, yang bisa saja berisi koma)
string SMT_AfterComma(const string line, const int n)
{
   int pos = -1;
   for(int i = 0; i < n; i++)
   {
      pos = StringFind(line, ",", pos + 1);
      if(pos < 0) return "";
   }
   string rest = StringSubstr(line, pos + 1);
   StringReplace(rest, "\"\"", "\"");
   if(StringLen(rest) >= 2 && StringGetCharacter(rest, 0) == '"')
      rest = StringSubstr(rest, 1, StringLen(rest) - 2);
   return rest;
}

//--- mengunduh 2 hari ke depan (rentangnya juga mencakup 6 jam terakhir)
bool SMT_Download()
{
   string url = "https://showmytrades.com/api/public/calendar/v1?format=csv&days=2&impact=" + SMT_Impact;
   if(StringLen(SMT_Currencies) > 0) url += "&currency=" + SMT_Currencies;

   char   post[], result[];
   string headers;
   ResetLastError();
   int status = WebRequest("GET", url, "", NULL, 10000, post, 0, result, headers);
   if(status != 200)
   {
      Print("[SMT] calendar download failed: HTTP ", status, ", error ", GetLastError(),
            ". Is https://showmytrades.com in Tools > Options > Expert Advisors > Allow WebRequest?");
      smt_nextDownload = TimeCurrent() + 60; // coba lagi dalam satu menit
      return false;
   }

   string body = CharArrayToString(result, 0, WHOLE_ARRAY, CP_UTF8);
   string lines[];
   int n = StringSplit(body, '\n', lines);

   ArrayResize(smt_eventTime, 0);
   ArrayResize(smt_eventTitle, 0);
   for(int i = 1; i < n; i++) // baris 0 adalah header
   {
      // baris terakhir "# server_time=1760702400 server_time_iso=...": jam UTC server
      if(StringFind(lines[i], "# server_time=") == 0)
      {
         long serverTime = StringToInteger(StringSubstr(lines[i], 14, 10));
         if(serverTime > 0)
         {
            smt_serverTime  = serverTime;
            smt_syncTick    = GetTickCount();
            smt_clockSynced = true;
         }
         continue;
      }
      string f[];
      if(StringSplit(lines[i], ',', f) < 8) continue;
      int k = ArraySize(smt_eventTime);
      ArrayResize(smt_eventTime, k + 1);
      ArrayResize(smt_eventTitle, k + 1);
      smt_eventTime[k]  = (datetime)StringToInteger(f[0]);      // detik Unix, UTC
      smt_eventTitle[k] = f[2] + " " + f[3] + ": " + SMT_AfterComma(lines[i], 7);
   }
   smt_nextDownload = TimeCurrent() + MathMax(SMT_RefreshMinutes, 15) * 60;
   Print("[SMT] calendar: ", ArraySize(smt_eventTime), " events loaded. UTC now ",
         TimeToString(SMT_Now(), TIME_DATE|TIME_MINUTES), ", broker clock is GMT",
         (SMT_BrokerGmtOffsetSeconds() >= 0 ? "+" : ""), DoubleToString(SMT_BrokerGmtOffsetSeconds() / 3600.0, 1));
   return true;
}

//--- true selama ada rilis di dalam jendela jeda; reason menyebut rilis yang mana
bool SMT_IsNewsTime(string &reason)
{
   reason = "";
   if(MQLInfoInteger(MQL_TESTER)) return false;   // tester tidak punya jaringan
   if(TimeCurrent() >= smt_nextDownload) SMT_Download();

   datetime now = SMT_Now();
   for(int i = 0; i < ArraySize(smt_eventTime); i++)
   {
      if(now >= smt_eventTime[i] - SMT_MinutesBefore * 60 && now <= smt_eventTime[i] + SMT_MinutesAfter * 60)
      {
         reason = smt_eventTitle[i];
         return true;
      }
   }
   return false;
}

Urutan kerjanya: menyusun permintaan dari input, mengunduh CSV, menyimpan satu stempel waktu dan satu label untuk setiap peristiwa, lalu menjawab satu-satunya pertanyaan yang penting bagi EA: apakah ada rilis di dalam jendela jeda saat ini?

πŸ”Œ Langkah 3: Panggil Sebelum Setiap Entry

Di EA Anda, sertakan file tersebut dan tanyakan dulu sebelum membuka posisi:

YourEA.mq4
#include <SMT_NewsFilter.mqh>

void OnTick()
{
   string news;
   if(SMT_IsNewsTime(news))
   {
      Comment("News filter active: ", news);
      return;                       // tidak ada entry baru selama jendela berita
   }
   Comment("");
   // ... logika entry Anda ...
}

Kelima input (SMT_Currencies, SMT_Impact, dan tiga nilai menit) muncul di jendela input EA seperti pengaturan lainnya, jadi setiap grafik bisa memakai nilainya sendiri.

Kompilasi ulang, pasang EA ke grafik, lalu lihat tab Experts (log Expert Advisor): baris pertama seharusnya [SMT] calendar: N events loaded. Pada hari yang sepi N bisa bernilai nol, dan itu memang benar, bukan kesalahan.

⏱️ Waktu, Jam, dan Tester

Tiga detail ini menentukan apakah filter aktif tepat pada menitnya.

DetailMengapa penting
API memakai UTC, dan memberi tahu jam berapa sekarangts adalah waktu Unix dalam detik, UTC. Setiap unduhan diakhiri dengan jam milik server (# server_time=…), lalu SMT_Now() meneruskannya dengan penghitung tick komputer, yang tidak terpengaruh zona waktu maupun pergantian waktu musim panas (DST). Tidak ada yang bergantung pada zona waktu broker, pada DST di negara mana pun, atau pada benar tidaknya zona waktu yang dipasang di VPS
Jangan pernah TimeCurrent()Waktu broker punya selisih dari UTC yang tidak bisa diketahui EA, dan selisih itu berubah dua kali setahun. SMT_BrokerGmtOffsetSeconds() mengukurnya untuk Anda, dan angka itu berguna tersendiri; filternya sendiri tidak pernah bergantung padanya
Strategy Tester (penguji strategi) tidak punya akses internetWebRequest() dinonaktifkan di sana, sehingga dalam backtest fungsinya selalu menjawab β€œtidak ada berita”. Untuk menguji filter berita pada data historis, dibutuhkan file lokal berisi peristiwa masa lalu, dan itu proyek lain lagi

πŸŽ›οΈ Menyetel Filter

  • Posisi terbuka. Kode ini hanya memblokir entry baru. Apakah posisi ditutup, stop diketatkan, atau justru dilonggarkan menjelang rilis adalah keputusan strategi; SMT_IsNewsTime() yang sama memberi tahu kapan harus melakukannya.
  • Hanya satu sisi pair. Isi SMT_Currencies dengan USD jika hanya berita dolar yang penting bagi Anda.
  • Dampak sedang juga. SMT_Impact = "high,medium" membuat jumlah peristiwa kira-kira tiga kali lipat. Cocok untuk scalper, tetapi sering kali terlalu banyak untuk sistem swing.
  • Hari libur. impact=all memasukkan hari libur pasar sebagai peristiwa sepanjang hari. Kebanyakan filter tidak membutuhkannya, dan pengaturan bawaan memang tidak menyertakannya.

πŸ” Memeriksa Datanya

Kalender yang sama juga tersedia sebagai halaman yang bisa dibaca: Kalender Ekonomi. Saat EA melaporkan jeda karena β€œUSD high: Nonfarm Payrolls”, peristiwa itu bisa Anda temukan di sana, lengkap dengan perkiraannya dan, setelah rilis, nilai aktualnya.

❓ Pertanyaan umum

Apakah saya perlu akun ShowMyTrades? Tidak. API kalender gratis dan terbuka, tanpa kunci. Pantau akun Anda di ShowMyTrades jika ingin punya halaman publik terverifikasi, tetapi filter berita tidak bergantung pada hal itu.

Berapa banyak lalu lintas data yang dihasilkan? Satu permintaan setiap 15 menit per grafik, masing-masing beberapa kilobyte. Sepuluh EA di satu terminal berarti 40 permintaan per jam. Batasnya 600 permintaan per menit per alamat IP.

Mengapa tidak langsung membaca Forex Factory? Bisa saja, dan banyak EA melakukannya. File mingguannya hanya mengizinkan dua unduhan setiap lima menit per alamat IP, yang bisa terasa sempit di VPS yang menjalankan banyak terminal, dan file itu tidak berisi nilai actual. Endpoint ShowMyTrades memfilter mata uang dan dampak di sisi server, hanya mengirim beberapa kilobyte, dan memang dirancang untuk polling.

Jam atau zona waktu VPS saya salah. Apakah filter tetap aktif tepat pada menitnya? Ya. Di setiap unduhan, server memberi tahu EA jam berapa sekarang dalam UTC, dan EA menjaga jam itu tetap berjalan dengan penghitungnya sendiri. VPS dengan zona waktu yang salah, atau jamnya meleset beberapa menit, tidak mengubah apa pun. Bahkan pergantian DST di VPS pun tidak berpengaruh: EA menghitung waktu yang berlalu dengan penghitung tick, bukan dengan jam.

Bagaimana jika unduhan gagal? Filter tetap memakai kalender terakhir yang berhasil dimuat dan mencoba lagi setelah satu menit. Jika belum pernah memuat satu pun (baru dijalankan, tidak ada internet), filter menjawab β€œtidak ada berita”, sehingga EA tetap trading. Jika bukan itu yang Anda inginkan, periksa ArraySize(smt_eventTime) == 0 dan tentukan sendiri langkahnya.

Apakah file yang sama bisa dipakai di MT5? Ya, tanpa perubahan. MT5 juga punya kalender bawaannya sendiri; pakai mana pun yang paling cocok.

πŸ”— Artikel terkait


Filternya hanya satu halaman kode dan satu URL. Jika EA Anda sudah dipantau di ShowMyTrades, transaksi yang dilewatinya di sekitar rilis berita bisa terlihat sebagai drawdown yang berhasil dihindari.