API Kalender Ekonomi Gratis untuk Sistem Trading Otomatis
Cepat atau lambat, setiap strategi otomatis sampai pada pertanyaan yang sama: apakah ada berita dalam setengah jam ke depan? Untuk menjawabnya dibutuhkan kalender ekonomi yang bisa dibaca mesin, dan ternyata kalender seperti itu lebih sulit dicari daripada kalendernya sendiri. Kebanyakan hanya berupa halaman web. Feed yang ada sering dibatasi jumlah permintaannya atau berbayar, dan sebagian menghilang tanpa pemberitahuan.
Panduan ini merangkum pencarian itu, ditambah endpoint yang akhirnya kami bangun dan buka untuk semua orang.
🗺️ Dari Mana Expert Advisor (EA) dan cBot Mendapatkan Kalender Saat Ini
| Sumber | Biaya | Yang didapat | Kelemahannya |
|---|---|---|---|
File mingguan Forex Factory (ff_calendar_thisweek.json, juga XML dan CSV) | Gratis | Minggu berjalan, tingkat dampak, dan perkiraan | Dua unduhan per lima menit per alamat IP: VPS dengan banyak terminal bisa menyentuh batas itu; file tidak memuat nilai aktual |
Kalender MT5 dari broker (fungsi MQL5 Calendar*) | Gratis | Kalender lengkap di dalam terminal | Hanya MT5; sebagian broker tidak meneruskannya |
| Scraping situs kalender | Gratis, sampai suatu saat tidak lagi | Apa pun yang tampil di halaman | Tata letak berubah, proteksi anti-bot, ketentuan penggunaan |
| API data pasar berbayar | Mulai puluhan dolar per bulan | Riwayat panjang, banyak negara | Lebih dari yang dibutuhkan kebanyakan sistem yang hanya ingin tahu “apakah ada berita dalam 30 menit” |
| API kecil milik swasta | Paket gratis dengan kunci | Sering bagus | Sering dikelola tim kecil; kunci dan batasnya bisa berubah |
Tidak ada yang salah dengan sumber-sumber ini. Hanya saja, masing-masing punya batas yang bisa tidak disadari oleh sistem yang berjalan tanpa pengawasan di VPS, sampai sistem itu telanjur bertransaksi tepat saat keputusan suku bunga diumumkan.
🎯 Apa yang Sebenarnya Dibutuhkan EA dan cBot
Kalau pertanyaannya disederhanakan, kebutuhannya ternyata sedikit:
- Satu atau dua hari ke depan, bukan setahun. Filter hanya melihat beberapa jam ke depan.
- Sudah disaring di server: hanya mata uang yang ditransaksikan, hanya tingkat dampak yang relevan. Cukup beberapa kilobyte, bukan satu megabyte.
- Stempel waktu Unix dalam UTC. Semua platform bisa membandingkan dua bilangan bulat; tidak ada yang senang mengurai tanggal di MQL.
- Jam yang bisa dipercaya. Jam yang dilihat EA atau cBot hanyalah tebakan: waktu broker dengan selisih yang tidak diketahui, VPS di zona waktu yang tidak diketahui. Kalender sebaiknya memberi tahu jam berapa sekarang, supaya sistem membandingkan dua hal yang setara.
- Dirancang untuk polling. Ratusan sistem yang bertanya setiap 15 menit harus dianggap lalu lintas normal, bukan penyalahgunaan.
- Tanpa kunci, tanpa akun. Setiap kunci berarti satu hal lagi yang bisa bocor, harus diganti berkala, dan perlu dikelola.
- Bisa dijangkau dari semua platform, termasuk yang membatasi akses jaringan.
🔓 Endpoint
GET https://showmytrades.com/api/public/calendar/v1?currency=EUR,USD&impact=high&days=1
| Parameter | Nilai | Bawaan |
|---|---|---|
currency | Satu atau lebih dari USD, EUR, GBP, JPY, AUD, NZD, CAD, CHF, CNY, dipisahkan koma | Kesembilannya |
impact | high, medium, low, holiday, dipisahkan koma, atau all | high |
days | 1 sampai 30 hari ke depan; jendela waktunya selalu dimulai 6 jam ke belakang | 1 |
format | json atau csv | json |
Setiap peristiwa memiliki ts (detik Unix, UTC), time (ISO 8601), currency, impact, title, forecast, previous, dan actual. Selain itu ada id tetap yang tidak berubah meski jadwalnya digeser, status (scheduled, moved dengan waktu lama di moved_from, tentative), dan confidence yang menunjukkan apakah tanggalnya dikonfirmasi oleh lembaga atau bank sentral yang merilis angka tersebut (official) atau oleh beberapa kalender yang saling cocok; feed perubahan terpisah mencantumkan apa saja yang digeser atau dibatalkan sejak unduhan terakhir Anda. Setiap respons juga menyebutkan waktu saat ini dalam UTC sebagai server_time: jam inilah yang dipakai sebagai pembanding ts, bukan jam broker atau jam VPS. Jika hanya butuh jamnya, GET https://showmytrades.com/api/public/time mengembalikan jam itu saja, tanpa pernah di-cache. Respons di-cache selama 15 menit dan membawa ETag; batasnya 600 permintaan per menit per alamat IP. Semuanya ada di halaman referensi, termasuk tata letak CSV yang dirancang agar StringSplit() di MQL tidak mungkin salah membacanya.
Tiga contoh permintaan, dalam tiga bahasa pemrograman:
curl "https://showmytrades.com/api/public/calendar/v1?currency=USD&impact=high,medium&days=7&format=csv"
import requests
events = requests.get(
"https://showmytrades.com/api/public/calendar/v1",
params={"currency": "EUR,USD", "impact": "high", "days": 2},
timeout=10,
).json()["events"]
next_release = min(events, key=lambda e: e["ts"]) if events else None
const res = await fetch('https://showmytrades.com/api/public/calendar/v1?currency=GBP&impact=high&days=1')
const { events } = await res.json()
const soon = events.filter(e => Math.abs(e.ts * 1000 - Date.now()) < 30 * 60 * 1000)
🔌 Per Platform
| Platform | Caranya | Kode |
|---|---|---|
| MetaTrader 4 | WebRequest() dengan https://showmytrades.com di daftar URL yang diizinkan | Satu file include, SMT_NewsFilter.mqh |
| MetaTrader 5 | File include yang sama, atau kalender bawaan | Kalender bawaan atau API, dengan kedua cuplikan kode |
| cTrader (desktop dan cloud) | WebSocket di port 25345, karena cTrader Cloud memblokir HTTP dari cBot | cBot lengkap dalam C# |
| Python, Node, apa pun yang mendukung HTTP | Endpoint di atas | Cuplikan kode di halaman ini |
| Asisten AI (Claude, ChatGPT) | Tool get_economic_calendar di server MCP, tanpa kunci | Tanyakan “berita USD berdampak tinggi apa saja minggu ini?” |
Kasus cTrader inilah alasan adanya WebSocket: cBot di cloud sama sekali tidak bisa mengirim permintaan HTTP, padahal banyak pengguna cTrader menjalankan cBot di cloud. Socket menerima empat parameter yang sama dan mengembalikan CSV yang sama.
🧭 Merancang Filternya Sendiri
API menjawab kapan. Strategi yang memutuskan apa yang harus dilakukan, dan pilihan yang biasa diambil adalah:
- Jendela waktu. 30 menit sebelum dan sesudah rilis berdampak tinggi adalah pengaturan yang umum. Scalper memperlebar jendela setelah rilis; sistem swing kadang hanya memblokir entry pada menit rilis.
- Mata uang yang dipantau. Kedua sisi pair yang ditransaksikan. Emas dan indeks biasanya cukup memantau
USD. - Posisi terbuka. Memblokir entry baru adalah bagian yang mudah. Menutup posisi atau merapatkan stop sebelum rilis adalah keputusan strategi, dengan biayanya sendiri.
- Kalau unduhan gagal. Jika unduhan gagal dan sistem tidak punya kalender, apakah sebaiknya tetap trading atau menunggu? Putuskan secara tegas; kode contoh memilih tetap trading, dan hal itu tertulis jelas di kodenya.
⚖️ Yang Tidak Diberikan API Ini
API ini adalah jadwal, disusun dari sumber kalender publik dan disajikan apa adanya. Rilis kadang digeser atau dibatalkan, pengumuman mendadak tentu saja tidak tercantum, dan tingkat dampak adalah klasifikasi, bukan prediksi seberapa jauh harga bergerak. Ini informasi untuk membangun filter, bukan sinyal.
❓ Pertanyaan umum
Apakah benar-benar gratis, juga untuk EA dan cBot komersial? Ya. Tanpa kunci, tanpa akun, tanpa paket. Tautan Economic calendar by ShowMyTrades yang mengarah ke halaman kalender akan kami hargai, tetapi tidak pernah diwajibkan.
Seberapa sering sistem sebaiknya memanggilnya?
Setiap 15 menit. Itulah masa berlaku cache, dan kalendernya memang tidak berubah lebih cepat dari itu. Dengan If-None-Match, kalender yang tidak berubah tidak memakan biaya apa pun.
Waktunya dalam zona waktu apa?
Selalu UTC. ts adalah waktu Unix dalam detik; time adalah momen yang sama dalam ISO 8601 dengan akhiran Z. Karena sistem otomatis jarang tahu sendiri jam berapa sekarang (waktu broker dengan selisih yang tidak diketahui, VPS di zona yang tidak diketahui), setiap respons membawa server_time, yaitu waktu UTC saat ini: hitung selisihnya dengan jam Anda sendiri sekali setiap unduhan, dan ambiguitasnya hilang.
Bisakah saya mendapatkan data historis untuk mem-backtest filter berita? Tidak dari endpoint ini: jendelanya hanya enam jam ke belakang dan paling jauh 30 hari ke depan. Kalender historis untuk backtest adalah produk lain dengan ketentuan yang berbeda.
Dari mana datanya berasal? Dari sumber kalender ekonomi publik, digabungkan dan dinormalisasi oleh ShowMyTrades. Data yang sama juga dipakai oleh halaman kalender di situs ini.
🔗 Artikel terkait
- Referensi API Kalender Ekonomi
- Cara menambahkan filter berita ke Expert Advisor MT4
- Filter berita di MT5: kalender bawaan atau API?
- Cara menambahkan filter berita ke cBot cTrader
Sistem yang tahu kapan harus menahan diri adalah sistem yang rekam jejaknya bisa Anda tunjukkan. Hubungkan akunnya secara gratis, dan setengah jam yang tenang di sekitar berita bisa terlihat di grafik drawdown.
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.
Panduan Praktis Memantau Kinerja Trading Anda 2026
Sebagian besar trader tidak tahu apakah mereka benar-benar trader yang bagus. Metrik yang penting, cara membacanya, dan apa yang ditunjukkan akun sungguhan tentang masing-masing metrik.