Otomatisasi·

Filter Berita di MT5: Kalender Bawaan atau API?

MetaTrader 5 dilengkapi kalender ekonomi yang bisa dibaca Expert Advisor tanpa mengunduh apa pun. Kapan kalender itu sudah cukup, kapan tidak, dan cara memakai API kalender gratis sebagai gantinya, lengkap dengan kode MQL5 untuk keduanya.

Bagi yang menulis Expert Advisor untuk MetaTrader 5, ada pilihan yang tidak dimiliki pengguna MT4: terminal sudah membawa kalender ekonomi sendiri, dan MQL5 bisa membacanya hanya dengan beberapa fungsi. Tanpa unduhan, tanpa URL yang perlu diizinkan, tanpa data yang perlu diurai.

Lalu, mengapa masih ada yang memakai API eksternal? Karena kalender bawaan punya batasan, dan tiga di antaranya berpengaruh pada filter berita. Panduan ini menunjukkan kode native, lalu kode untuk API, dan kapan sebaiknya memilih masing-masing.

⚖️ Dua Pilihan Berdampingan

FiturKalender bawaan MQL5API kalender ShowMyTrades
PersiapanTidak perluIzinkan https://showmytrades.com di Tools → Options → Expert Advisors (Alat → Opsi → Expert Advisors)
Sumber dataMetaQuotes, dikirim lewat server brokerSumber kalender publik yang digabungkan oleh ShowMyTrades, dengan tanggal rilis utama dicocokkan ke lembaga penerbit dan bank sentral (confidence: official)
Tersedia diBroker yang mengaktifkannya (sebagian besar mengaktifkan; beberapa server white label tidak)Broker mana pun, di terminal mana pun yang terhubung ke internet
Juga berjalan di MT4TidakYa, dengan file yang sama
Berjalan di Strategy Tester (penguji strategi)Ya, dengan data historisTidak (tester tidak punya jaringan)
Zona waktuWaktu server trading, dengan selisih dari UTC yang harus Anda hitung sendiriUTC (ts dalam detik Unix), dan setiap respons membawa waktu UTC server saat itu, sehingga EA tidak bergantung pada jam broker maupun jam VPS
NilaiPerkiraan, sebelumnya, aktual, beserta revisinyaPerkiraan, sebelumnya, aktual
BiayaGratisGratis, tanpa kunci

🧱 Opsi A: Kalender Bawaan

Fungsi di bawah ini memeriksa apakah ada rilis berdampak tinggi untuk salah satu mata uang simbol di grafik yang jatuh di dalam jendela jeda. Waktunya memakai waktu server trading, sesuai yang diharapkan CalendarValueHistory().

NativeNewsFilter.mqh
//--- kalender bawaan MQL5: true selama ada rilis berdampak tinggi untuk mata uang
//--- grafik di dalam rentang [-minutesBefore, +minutesAfter] dari sekarang
bool NativeNewsTime(const int minutesBefore, const int minutesAfter, string &reason)
{
   reason = "";
   datetime now  = TimeTradeServer();
   datetime from = now - minutesAfter * 60;
   datetime to   = now + minutesBefore * 60;

   string currencies[2];
   currencies[0] = SymbolInfoString(_Symbol, SYMBOL_CURRENCY_BASE);
   currencies[1] = SymbolInfoString(_Symbol, SYMBOL_CURRENCY_PROFIT);

   for(int c = 0; c < 2; c++)
   {
      if(c == 1 && currencies[1] == currencies[0]) break;
      MqlCalendarValue values[];
      if(CalendarValueHistory(values, from, to, NULL, currencies[c]) <= 0) continue;
      for(int i = 0; i < ArraySize(values); i++)
      {
         MqlCalendarEvent ev;
         if(!CalendarEventById(values[i].event_id, ev)) continue;
         if(ev.importance != CALENDAR_IMPORTANCE_HIGH) continue;
         reason = currencies[c] + ": " + ev.name;
         return true;
      }
   }
   return false;
}

Panggil dari OnTick() persis seperti filter lainnya:

string news;
if(NativeNewsTime(30, 30, news)) { Comment("News filter: ", news); return; }

Tiga hal yang perlu diketahui sebelum mengandalkannya:

  1. Bergantung pada broker. Kalender sampai ke terminal lewat server trading. Jika CalendarValueHistory() mengembalikan -1 dengan kode kesalahan 5402 di broker Anda, kalender tidak diaktifkan di sana, dan tidak ada kode yang bisa mengubahnya.
  2. Memakai waktu server, bukan UTC. Di grafik yang sedang berjalan, ini tidak masalah. Repotnya muncul begitu waktunya dibandingkan dengan data lain.
  3. Hanya untuk MT5. EA yang juga Anda rilis untuk MT4 butuh implementasi kedua.

🌐 Opsi B: API Kalender

Alternatifnya adalah endpoint HTTP gratis yang mengembalikan berita beberapa hari ke depan untuk mata uang dan tingkat dampak pilihan Anda, dalam format CSV atau JSON:

https://showmytrades.com/api/public/calendar/v1?currency=EUR,USD&impact=high&days=2&format=csv

File include SMT_NewsFilter.mqh yang membacanya dimuat lengkap di panduan MT4 dan di referensi API. File ini bisa dikompilasi di MQL5 tanpa perubahan: simpan di MQL5\Include, izinkan https://showmytrades.com di Tools → Options → Expert Advisors (Alat → Opsi → Expert Advisors), lalu panggil:

#include <SMT_NewsFilter.mqh>

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

File ini mengunduh sekali setiap 15 menit, membandingkan waktu dalam UTC dengan SMT_Now() (jam server kalender), dan menaruh input (SMT_Currencies, SMT_Impact, menit sebelum dan sesudah) di jendela pengaturan EA.

🎯 Mana yang Dipilih

Situasi AndaPilihan
Hanya MT5, broker menyediakan kalender, dan filternya ingin Anda uji lewat backtestBawaan
EA yang sama untuk MT4 dan MT5API: satu file, perilaku sama
Broker tanpa kalender (5402)API
Anda juga menjalankan cBot di cTraderAPI: data yang sama di cTrader
Anda ingin mencatat berita bersama transaksinya untuk ditinjau nantiKeduanya bisa; API memberikan stempel waktu UTC yang cocok dengan log Anda yang lain

Tidak ada yang melarang memakai keduanya sekaligus: kalender bawaan saat ia memberi jawaban, API saat tidak. Dalam praktik, satu saja sudah cukup.

🧪 Backtest Filter Berita

Dari dua pilihan itu, hanya kalender bawaan yang berjalan di Strategy Tester (penguji strategi), karena tester tidak punya akses internet. Meski begitu, berhati-hatilah dengan apa yang sebenarnya dibuktikan oleh backtest sebuah filter berita: pengujian memakai kalender seperti yang diketahui hari ini, dengan jadwal yang sudah direvisi dan peristiwa yang baru ditambahkan belakangan. Filter yang berjalan secara riil hanya tahu apa yang dijadwalkan pada saat itu.

❓ Pertanyaan umum

Apakah kalender bawaan MT5 gratis? Ya. Kalender itu bagian dari terminal, dikirim lewat server broker Anda, dan tidak ada pengaturan yang perlu diaktifkan dari sisi Anda.

Mengapa CalendarValueHistory() tidak mengembalikan apa pun di broker saya? Sebagian server, sering kali server white label, tidak meneruskan kalender. Periksa GetLastError(): 5402 berarti kalender tidak tersedia. Dalam kasus itu, gunakan API.

Bisakah saya memfilter berdasarkan mata uang simbol lain? Bisa. Masukkan kode mata uang yang diinginkan alih-alih membacanya dari _Symbol. Versi API menerimanya sebagai string input, EUR,USD,GBP.

Apakah API-nya memerlukan akun? Tidak. Tanpa kunci, tanpa perlu masuk. Batasnya 600 permintaan per menit per alamat IP, jauh di atas kebutuhan pengaturan biasa yang mengirim satu permintaan setiap 15 menit per grafik.

🔗 Artikel terkait


Kalender mana pun yang Anda pilih, hasilnya bisa terlihat di rekam jejak: lebih sedikit transaksi yang dibuka tepat saat harga melonjak, dan sering kali drawdown yang lebih landai. Pantau akun MT5 Anda gratis dan lihat sendiri hasilnya di grafik.