Otomatisasi·

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.

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

SumberBiayaYang didapatKelemahannya
File mingguan Forex Factory (ff_calendar_thisweek.json, juga XML dan CSV)GratisMinggu berjalan, tingkat dampak, dan perkiraanDua 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*)GratisKalender lengkap di dalam terminalHanya MT5; sebagian broker tidak meneruskannya
Scraping situs kalenderGratis, sampai suatu saat tidak lagiApa pun yang tampil di halamanTata letak berubah, proteksi anti-bot, ketentuan penggunaan
API data pasar berbayarMulai puluhan dolar per bulanRiwayat panjang, banyak negaraLebih dari yang dibutuhkan kebanyakan sistem yang hanya ingin tahu “apakah ada berita dalam 30 menit”
API kecil milik swastaPaket gratis dengan kunciSering bagusSering 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:

  1. Satu atau dua hari ke depan, bukan setahun. Filter hanya melihat beberapa jam ke depan.
  2. Sudah disaring di server: hanya mata uang yang ditransaksikan, hanya tingkat dampak yang relevan. Cukup beberapa kilobyte, bukan satu megabyte.
  3. Stempel waktu Unix dalam UTC. Semua platform bisa membandingkan dua bilangan bulat; tidak ada yang senang mengurai tanggal di MQL.
  4. 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.
  5. Dirancang untuk polling. Ratusan sistem yang bertanya setiap 15 menit harus dianggap lalu lintas normal, bukan penyalahgunaan.
  6. Tanpa kunci, tanpa akun. Setiap kunci berarti satu hal lagi yang bisa bocor, harus diganti berkala, dan perlu dikelola.
  7. 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
ParameterNilaiBawaan
currencySatu atau lebih dari USD, EUR, GBP, JPY, AUD, NZD, CAD, CHF, CNY, dipisahkan komaKesembilannya
impacthigh, medium, low, holiday, dipisahkan koma, atau allhigh
days1 sampai 30 hari ke depan; jendela waktunya selalu dimulai 6 jam ke belakang1
formatjson atau csvjson

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"

🔌 Per Platform

PlatformCaranyaKode
MetaTrader 4WebRequest() dengan https://showmytrades.com di daftar URL yang diizinkanSatu file include, SMT_NewsFilter.mqh
MetaTrader 5File include yang sama, atau kalender bawaanKalender bawaan atau API, dengan kedua cuplikan kode
cTrader (desktop dan cloud)WebSocket di port 25345, karena cTrader Cloud memblokir HTTP dari cBotcBot lengkap dalam C#
Python, Node, apa pun yang mendukung HTTPEndpoint di atasCuplikan kode di halaman ini
Asisten AI (Claude, ChatGPT)Tool get_economic_calendar di server MCP, tanpa kunciTanyakan “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


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.