exchangerate.dev1. Kelas sumber
Field publik source menjelaskan kelas data, bukan vendor. live adalah data pasar spot indikatif yang dapat diperbarui dalam interval singkat selama pekan perdagangan antarbank. ecb_daily adalah kurs acuan Bank Sentral Eropa, yang biasanya diterbitkan sekali setiap hari kerja. market_daily menyimpan kurs penutupan harian dari umpan data pasar untuk mata uang tanpa penetapan kurs acuan ECB.
Respons dengan beberapa mata uang menyertakan peta sources untuk setiap mata uang yang dikutip. Field source pada tingkat teratas bersifat konservatif: field ini melaporkan kelas data yang paling tidak mutakhir dalam respons tersebut.
Referensi: kurs acuan euro ECB.
2. Waktu dan status pasar
data_updated_at adalah waktu terakhir pengamatan yang mendasarinya ditulis. timestamp adalah waktu respons API dibuat. Gunakan yang pertama untuk menghitung usia data dan yang kedua untuk mengaudit waktu permintaan.
market_session bernilai open selama pekan antarbank, weekend setelah penutupan Jumat pukul 17:00 waktu New York hingga Minggu pukul 17:00 waktu New York, atau interbank_closed untuk penutupan yang diketahui di luar akhir pekan. Respons pada akhir pekan dapat memuat pengamatan terakhir dari pekan perdagangan; label tersebut tidak berarti ada kutipan kurs baru pada akhir pekan.
3. Perubahan mata uang dasar dan kurs silang turunan
Kurs dinormalisasi agar pemanggil dapat meminta mata uang dasar apa pun yang didukung. Jika suatu pasangan tidak diamati secara langsung, API menghitungnya dengan triangulasi melalui pasangan komponen yang tersedia. Nilai turunan diidentifikasi dalam derived_symbols; respons untuk satu pasangan juga menampilkan derived dan batas derivation_bps_max jika berlaku.
Kurs silang mewarisi sumber yang paling tidak mutakhir dari pasangan komponennya. Aplikasi yang tidak dapat menerima kurs turunan harus memeriksa field penurunan kurs, bukan menyimpulkannya dari pasangan mata uang.
4. Pengamatan historis
Riwayat harian menggabungkan penetapan kurs acuan dan kurs penutupan pasar. Data mata uang utama tersedia hingga 1999; sekitar 30 menggunakan penetapan kurs acuan ECB, 113 lainnya menggunakan kurs penutupan pasar, dan tanggal awal data bervariasi menurut pasangan. Pada akhir pekan atau hari libur tanpa penetapan kurs acuan baru, pengamatan sebelumnya dapat diteruskan dan diberi label is_forward_filled: true. API tidak mengarang penetapan kurs acuan yang belum diterbitkan.
5. Validasi dan penerbitan
- Pengenal mata uang dinormalisasi menjadi kode huruf besar bergaya ISO sebelum penentuan kurs.
- Field sumber dan waktu pembaruan disertakan bersama pengamatan, bukan disimpulkan oleh klien.
- Jika pengamatan langsung tidak tersedia atau terlalu lama, sistem beralih ke kelas acuan harian yang tersedia, alih-alih memberinya label langsung.
- Setiap paket menggunakan sumber yang sama; pemanggil Free dan tanpa kunci menerima kurs langsung dengan keterlambatan 15 menit.
- Riset yang diterbitkan harus mencantumkan rentang waktu pengukuran, jumlah sampel, metode, dan keterbatasannya.
6. Keterbatasan
Kurs ini merupakan kurs acuan indikatif, bukan kutipan harga beli/jual yang dapat dieksekusi. Kurs ini tidak mencakup selisih harga dan biaya dari bank, penerbit kartu, pialang, penyedia pembayaran, atau pedagang valuta asing tunai. Kurs ini tidak boleh digunakan untuk penyelesaian transaksi, pelaksanaan pembayaran, perdagangan yang diregulasi, atau sebagai sumber catatan resmi. Cakupan dan kemutakhiran dapat bervariasi menurut mata uang, ketersediaan sumber, penutupan pasar, dan jadwal penerbitan lembaga acuan.
7. Standar tolok ukur kemutakhiran
Kami menerbitkan protokol sebelum menerbitkan peringkat. Tolok ukur kemutakhiran API kurs yang dapat direproduksi menetapkan rentang waktu pengamatan, persyaratan cap waktu, metrik, pengecualian, dan ukuran sampel minimum. Protokol yang dapat dibaca mesin tersebut saat ini belum memuat hasil penyedia mana pun; hasil hanya akan ditambahkan setelah ambang bukti yang dinyatakan terpenuhi.
Riwayat revisi
1.1 · 9 Oktober 2026: Memperjelas keterlambatan Free dan kurs penutupan pasar harian.
1.0 · 16 Juli 2026: Metodologi publik awal, makna sumber, aturan sesi pasar, kebijakan penurunan kurs, perilaku data historis, keterbatasan, dan standar penerbitan tolok ukur.
Koreksi: hello@exchangerate.dev