Cara Menambahkan Filter Berita ke cBot cTrader (Termasuk Cloud)
Filter berita di cBot menabrak dua tembok yang tidak pernah ditemui developer MetaTrader. Pertama, cTrader Automate API tidak punya kalender ekonomi: platformnya memang menampilkan kalender, tetapi cBot tidak bisa membacanya. Kedua, banyak trader menjalankan cBot di cTrader Cloud, dan di sana cBot sama sekali tidak bisa mengirim permintaan HTTP: Http.Get() hanya mengembalikan status 503.
Hanya satu jalur yang dibuka di cloud: WebSocket di port 25345. Lewat jalur itulah kalender ekonomi gratis ShowMyTrades sampai ke cBot. Panduan ini memuat semuanya: idenya, protokolnya, dan cBot yang bisa langsung dikompilasi apa adanya.
π§ Cara Kerjanya
cBot (desktop atau cloud) ShowMyTrades
ββββββββββββββββββββββββββββ βββββββββββββββββββββββββββ
β tiap 15 menit: β ws://β¦:25345 β kalender yang sama di β
β buka socket, kirim β βββββββββββββββΊ β /api/public/calendar/v1 β
β "currency=EUR,USD& β β di-cache, disaring, β
β impact=high&days=2& β βββββββββββββββ β beberapa kilobyte β
β format=csv" β teks CSV βββββββββββββββββββββββββββ
β urai, tutup β
β tiap tick: IsNewsTime() β
ββββββββββββββββββββββββββββ
| Komponen | Nilai |
|---|---|
| Alamat | ws://showmytrades.com:25345/ |
| Yang Anda kirim | Satu baris teks dengan parameter yang sama seperti API HTTP: currency, impact, days, format |
| Yang Anda terima | Satu frame teks berisi body CSV (atau JSON) |
| Hak akses | AccessRights.None sudah cukup, jadi cBot bisa dipublikasikan |
| Kunci atau akun | Tidak perlu |
| Cadangan di desktop | Di desktop HTTP biasa tetap berfungsi; kode di bawah beralih ke HTTP jika socket gagal |
Socket memakai ws://, bukan wss://, karena protokol itulah yang dipakai cTrader Cloud untuk terhubung. Tidak ada data pribadi maupun data akun yang lewat di sana, hanya keempat parameter tadi.
π Kode cBot
Buat cBot baru di cTrader Automate, ganti seluruh kodenya dengan kode di bawah, lalu jalankan Build (kompilasi). Di desktop, kode ini dikompilasi dengan paket cTrader.Automate dari NuGet; di cloud, cBot langsung berjalan apa adanya.
// Filter berita untuk cTrader (desktop dan cloud), data dari ShowMyTrades, gratis, tanpa kunci.
// Dokumentasi: https://showmytrades.com/docs/api/economic-calendar
using System;
using System.Collections.Generic;
using cAlgo.API;
namespace cAlgo.Robots
{
[Robot(AccessRights = AccessRights.None, TimeZone = TimeZones.UTC)]
public class SmtNewsFilterBot : Robot
{
[Parameter("News: currencies (comma-separated, empty = all)", DefaultValue = "EUR,USD")]
public string NewsCurrencies { get; set; }
[Parameter("News: impact (high | high,medium | all)", DefaultValue = "high")]
public string NewsImpact { get; set; }
[Parameter("News: minutes before", DefaultValue = 30, MinValue = 0)]
public int MinutesBefore { get; set; }
[Parameter("News: minutes after", DefaultValue = 30, MinValue = 0)]
public int MinutesAfter { get; set; }
private const string CalendarWs = "ws://showmytrades.com:25345/";
private const string CalendarHttp = "https://showmytrades.com/api/public/calendar/v1?";
private static readonly DateTime Epoch = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
private readonly List<KeyValuePair<DateTime, string>> _events = new List<KeyValuePair<DateTime, string>>();
private WebSocketClient _ws;
private bool _received;
protected override void OnStart()
{
DownloadCalendar();
Timer.Start(TimeSpan.FromMinutes(15));
}
protected override void OnTimer()
{
DownloadCalendar();
}
protected override void OnTick()
{
string reason;
if (IsNewsTime(out reason))
{
// Tidak ada entry baru selama jendela berita. Kelola posisi terbuka sesuai keinginan Anda.
return;
}
// ... logika entry Anda ...
}
protected override void OnStop()
{
CloseSocket();
}
// True selama ada rilis di dalam jendela jeda; reason menyebut rilis yang mana.
// Server.TimeInUtc adalah jam UTC milik cTrader sendiri: platform mengetahui selisih waktu broker,
// jadi aman dibandingkan dengan kalender (ParseCsv mencocokkannya dengan server).
public bool IsNewsTime(out string reason)
{
DateTime now = Server.TimeInUtc;
foreach (KeyValuePair<DateTime, string> e in _events)
{
if (now >= e.Key.AddMinutes(-MinutesBefore) && now <= e.Key.AddMinutes(MinutesAfter))
{
reason = e.Value;
return true;
}
}
reason = null;
return false;
}
private string Query()
{
string q = "format=csv&days=2&impact=" + NewsImpact;
if (!string.IsNullOrWhiteSpace(NewsCurrencies)) q += "¤cy=" + NewsCurrencies.Replace(" ", "");
return q;
}
private void DownloadCalendar()
{
if (RunningMode != RunningMode.RealTime) return; // tidak ada jaringan di backtester
// cTrader Cloud memblokir HTTP dari cBot dan hanya mengizinkan WebSocket di port 25345,
// jadi socket adalah jalur utama di mana pun; HTTP menjadi cadangan di desktop.
try
{
CloseSocket();
_received = false;
_ws = new WebSocketClient(new WebSocketClientOptions { Timeout = TimeSpan.FromSeconds(15) });
_ws.Connected += OnSocketConnected;
_ws.TextReceived += OnSocketText;
_ws.Disconnected += OnSocketDisconnected;
_ws.Connect(new Uri(CalendarWs));
}
catch (Exception ex)
{
Print("[SMT] calendar socket failed: {0}", ex.Message);
DownloadOverHttp();
}
}
private void OnSocketConnected(WebSocketClientConnectedEventArgs args)
{
try { _ws.Send(Query()); }
catch (Exception ex) { Print("[SMT] calendar send failed: {0}", ex.Message); }
}
private void OnSocketText(WebSocketClientTextReceivedEventArgs args)
{
_received = true;
if (args.Text.StartsWith("Error:")) Print("[SMT] calendar: {0}", args.Text);
else ParseCsv(args.Text);
CloseSocket();
}
private void OnSocketDisconnected(WebSocketClientDisconnectEventArgs args)
{
if (!_received) DownloadOverHttp(); // hanya di desktop: cloud menjawab 503
}
private void DownloadOverHttp()
{
try
{
HttpResponse r = Http.Get(CalendarHttp + Query());
if (r.IsSuccessful) ParseCsv(r.Body);
else Print("[SMT] calendar HTTP failed: {0}", r.StatusCode);
}
catch (Exception ex) { Print("[SMT] calendar HTTP failed: {0}", ex.Message); }
}
private void CloseSocket()
{
WebSocketClient ws = _ws;
_ws = null;
if (ws == null) return;
try { ws.Connected -= OnSocketConnected; ws.TextReceived -= OnSocketText; ws.Disconnected -= OnSocketDisconnected; } catch (Exception) { }
try { if (ws.State == WebSocketClientState.Open) ws.Close(WebSocketClientCloseStatus.NormalClosure, "done"); } catch (Exception) { }
try { ws.Dispose(); } catch (Exception) { }
}
// CSV: ts,time,currency,impact,forecast,previous,actual,title (title paling akhir, bisa diapit tanda kutip),
// lalu satu baris terakhir "# server_time=<unix> server_time_iso=<iso>" berisi jam UTC server.
private void ParseCsv(string csv)
{
List<KeyValuePair<DateTime, string>> list = new List<KeyValuePair<DateTime, string>>();
foreach (string raw in csv.Split('\n'))
{
string line = raw.TrimEnd('\r');
if (line.Length == 0 || line.StartsWith("ts,")) continue;
if (line.StartsWith("# server_time="))
{
long serverTime;
if (long.TryParse(line.Substring(14, 10), out serverTime))
{
double skew = (Server.TimeInUtc - Epoch.AddSeconds(serverTime)).TotalSeconds;
if (Math.Abs(skew) > 60) Print("[SMT] warning: cTrader's UTC clock is {0:F0} s away from the calendar server", skew);
}
continue;
}
string[] f = line.Split(',');
if (f.Length < 8) continue;
long ts;
if (!long.TryParse(f[0], out ts)) continue;
DateTime at = Epoch.AddSeconds(ts);
string title = AfterComma(line, 7).Replace("\"\"", "\"");
if (title.Length >= 2 && title[0] == '"') title = title.Substring(1, title.Length - 2);
list.Add(new KeyValuePair<DateTime, string>(at, f[2] + " " + f[3] + ": " + title));
}
_events.Clear();
_events.AddRange(list);
Print("[SMT] calendar: {0} events loaded", _events.Count);
}
private static string AfterComma(string line, int n)
{
int pos = -1;
for (int i = 0; i < n; i++)
{
pos = line.IndexOf(',', pos + 1);
if (pos < 0) return "";
}
return line.Substring(pos + 1);
}
}
}
Ingin memasang filter ini di cBot yang sudah ada? Salin semua bagian dari CalendarWs sampai AfterComma() ke cBot tersebut, panggil DownloadCalendar() dari OnStart() dan dari timer 15 menit, lalu periksa IsNewsTime() sebelum setiap entry.
π§ͺ Cara Mencobanya
- Build cBot, lalu tambahkan satu instance ke grafik. Dalam beberapa detik, log seharusnya menampilkan
[SMT] calendar: N events loaded. Angka nol di akhir pekan yang sepi itu wajar. - Atur News: impact ke
alldan News: minutes before ke angka besar supaya filter terlihat bekerja, lalu kembalikan ke nilai sebenarnya. - Jalankan instance yang sama di cloud: baris log-nya sama persis. Untuk itulah socket dipakai.
β±οΈ Waktu dan Backtester
Stempel waktu kalender dalam UTC, dan kode membandingkannya dengan Server.TimeInUtc, sehingga zona waktu broker dan pergantian waktu musim panas (daylight saving time) sama sekali tidak ikut campur. Setiap unduhan juga diakhiri dengan jam UTC milik server (# server_time=β¦): cBot mencocokkan Server.TimeInUtc dengan jam itu dan mencetak peringatan jika selisihnya lebih dari satu menit, jadi jam yang salah tidak akan luput dari perhatian. Backtester dan optimizer tidak punya akses jaringan: di sana DownloadCalendar() langsung berhenti dan filter tidak melakukan apa-apa. Untuk mem-backtest filter berita, cBot perlu disertai file berisi peristiwa masa lalu, dan itu pekerjaan tersendiri.
ποΈ Penyesuaian
- Posisi terbuka tidak disentuh. Gunakan
IsNewsTime()untuk memutuskan nasibnya: ditutup, diberi trailing stop, atau dibiarkan. - Dampak sedang (
high,medium) membuat jumlah peristiwa menjadi tiga kali lipat. Scalper sering membutuhkannya, sistem swing jarang. - Beberapa cBot di satu akun mengunduh kalender masing-masing: sepuluh cBot berarti 40 permintaan kecil per jam, jauh di bawah batas 60 pesan socket per menit per alamat IP.
β Pertanyaan umum
Mengapa WebSocket, bukan HTTPS? Karena cTrader Cloud tidak mengizinkan cBot mengirim permintaan HTTP, dan koneksi WebSocket hanya diizinkan di port 25345. Di desktop, cBot yang sama juga bisa bekerja lewat HTTPS, dan kodenya otomatis beralih ke HTTPS jika socket tidak bisa terhubung.
Apakah aman mengirim lewat ws:// tanpa enkripsi?
Permintaannya hanya berisi empat parameter (mata uang, dampak, jumlah hari, format) dan tidak memuat apa pun tentang Anda atau akun trading; responsnya berupa kalender publik. Tidak ada yang perlu dilindungi. Data yang sama tersedia lewat HTTPS dari endpoint API.
Apakah perlu AccessRights.FullAccess?
Tidak. WebSocketClient dan Http sudah tersedia dengan AccessRights.None, dan hak akses itu pula yang disyaratkan cTrader Store.
Apakah saya perlu akun ShowMyTrades? Tidak. Jika Anda juga ingin memublikasikan hasil cBot, menghubungkan akun cTrader adalah urusan terpisah dan cukup dengan satu kali otorisasi OAuth.
π Artikel terkait
- Referensi API Kalender Ekonomi: protokol WebSocket, endpoint HTTP, format JSON dan CSV
- Cara menambahkan filter berita ke Expert Advisor MT4: filter yang sama dalam MQL
- Cara menampilkan hasil cTrader di situs web Anda
- Apa itu cTrader
Socket adalah satu-satunya bagian yang tidak biasa, dan kodenya sudah tersedia. Sisanya tinggal strategi Anda, dan satu celah kerugian di sekitar berita kini sudah tertutup. Pantau akunnya gratis dan lihat bedanya di grafik drawdown.
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.
API Kalender Ekonomi Gratis untuk Sistem Trading Otomatis
Dari mana sistem trading otomatis bisa mendapatkan kalender ekonomi: sumber yang biasa dipakai, kelemahan masing-masing, dan API gratis tanpa kunci yang dirancang untuk polling dari Expert Advisor, cBot, Python, dan JavaScript.