Filter Berita di MT5: Kalender Bawaan atau API?
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
| Fitur | Kalender bawaan MQL5 | API kalender ShowMyTrades |
|---|---|---|
| Persiapan | Tidak perlu | Izinkan https://showmytrades.com di Tools → Options → Expert Advisors (Alat → Opsi → Expert Advisors) |
| Sumber data | MetaQuotes, dikirim lewat server broker | Sumber kalender publik yang digabungkan oleh ShowMyTrades, dengan tanggal rilis utama dicocokkan ke lembaga penerbit dan bank sentral (confidence: official) |
| Tersedia di | Broker yang mengaktifkannya (sebagian besar mengaktifkan; beberapa server white label tidak) | Broker mana pun, di terminal mana pun yang terhubung ke internet |
| Juga berjalan di MT4 | Tidak | Ya, dengan file yang sama |
| Berjalan di Strategy Tester (penguji strategi) | Ya, dengan data historis | Tidak (tester tidak punya jaringan) |
| Zona waktu | Waktu server trading, dengan selisih dari UTC yang harus Anda hitung sendiri | UTC (ts dalam detik Unix), dan setiap respons membawa waktu UTC server saat itu, sehingga EA tidak bergantung pada jam broker maupun jam VPS |
| Nilai | Perkiraan, sebelumnya, aktual, beserta revisinya | Perkiraan, sebelumnya, aktual |
| Biaya | Gratis | Gratis, 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().
//--- 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:
- Bergantung pada broker. Kalender sampai ke terminal lewat server trading. Jika
CalendarValueHistory()mengembalikan-1dengan kode kesalahan5402di broker Anda, kalender tidak diaktifkan di sana, dan tidak ada kode yang bisa mengubahnya. - Memakai waktu server, bukan UTC. Di grafik yang sedang berjalan, ini tidak masalah. Repotnya muncul begitu waktunya dibandingkan dengan data lain.
- 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 Anda | Pilihan |
|---|---|
| Hanya MT5, broker menyediakan kalender, dan filternya ingin Anda uji lewat backtest | Bawaan |
| EA yang sama untuk MT4 dan MT5 | API: satu file, perilaku sama |
Broker tanpa kalender (5402) | API |
| Anda juga menjalankan cBot di cTrader | API: data yang sama di cTrader |
| Anda ingin mencatat berita bersama transaksinya untuk ditinjau nanti | Keduanya 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
- Cara menambahkan filter berita ke Expert Advisor MT4: file include lengkap
- Referensi API kalender ekonomi: parameter, format, dan batas
- Cara menambahkan filter berita ke cBot cTrader
- Apa itu Expert Advisor
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.
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.
Cara Menambahkan Filter Berita ke cBot cTrader (Termasuk Cloud)
cTrader tidak menyediakan API kalender untuk cBot, dan cTrader Cloud memblokir permintaan HTTP. Berikut filter berita yang berjalan di desktop maupun di cloud, dengan kalender gratis lewat WebSocket dan kode C# lengkap.