Dokumentasi /

Nilai tukar historis

Gunakan tanggal pada path untuk satu observasi atau `/v1/range` untuk deret harian. Data yang diterbitkan dimulai pada 1999-01-04.

Minta satu tanggal

Pada akhir pekan atau hari libur, respons memakai fixing terakhir yang diterbitkan dan `is_forward_filled` bernilai true. Sistem tidak membuat observasi baru.

bash · one date
curl "https://api.exchangerate.dev/v1/2024-01-15/EUR?symbols=USD,GBP"

Minta rentang tanggal

Kirim `symbols`, `start_date`, dan `end_date`. JSON memuat hingga 366 baris per halaman; teruskan `next_cursor` ketika `has_more` bernilai true.

bash · date range
curl "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-06-30"

Unduh CSV atau Parquet

Tambahkan `format=csv` atau `format=parquet`. Unduhan mencakup seluruh rentang yang diminta dan tidak memakai cursor JSON.

bash · CSV
curl -L "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-12-31&format=csv"   --output usd-rates-2024.csv

Simpan provenance bersama nilai

Simpan `source`, `is_forward_filled`, dan `derived_symbols` pada setiap observasi agar nilainya dapat dijelaskan kembali.

source · is_forward_filled · derived_symbols

Deret intraday dan cakupan

/v1/timeseries mendukung 1m, 5m, 15m, 1h, 4h dan referensi harian 1d; tidak ada 2h. Pasangan silang SGD tanpa USD tidak mendukung 4h, tetapi USD/SGD dan kebalikannya didukung. Data pasar mulai dikumpulkan pada 2026-09-14. Retensi 1m adalah 30 hari; interval lebih besar tidak memiliki kedaluwarsa terjadwal. Retensi bukan jaminan kedalaman data yang sudah tersedia.

Pasangan silang historis memerlukan tick penutupan nyata dalam bucket UTC yang sama, dengan selisih maksimal 5 detik. effective_at memakai waktu observasi tertua. Celah tidak diisi; bucket yang masih terbuka dapat berubah. 1d menggunakan referensi harian untuk seluruh katalog. Tabel menghitung pasangan unik; kedua arah didukung.

intervalPasangan unik
1m91
5m91
15m91
1h91
4h79
1d465
curl · EUR/JPY · 15m
curl "https://api.exchangerate.dev/v1/timeseries?base=EUR&symbols=JPY&interval=15m&from=2026-09-14T12:00:00Z&to=2026-09-14T13:00:00Z"

Rentang yang didukung tanpa observasi mengembalikan HTTP 200 dengan data: [], has_more: false dan next_cursor: null. Interval tidak dikenal menghasilkan unsupported_interval; pasangan di luar cakupan menghasilkan unsupported_pair_interval dan rejected_pairs (HTTP 400). Permintaan campuran ditolak seluruhnya.

AUD, CAD, CHF, EUR, GBP, JPY, MXN, NOK, NZD, PLN, SEK, SGD, USD, ZAR

Rincian cakupan dan batas

API nilai tukar intrahari