Menu

Nilai tukar historis

Tanggal di path atau `/v1/range`: Plus/Pro sejak 1999-01-04, Basic 1 tahun, Free dan tanpa key 30 hari.

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 · Plus / Pro
curl "https://api.exchangerate.dev/v1/2024-01-15/EUR?symbols=USD,GBP" \  -H "Authorization: Bearer YOUR_API_KEY"

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 · Plus / Pro
curl "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-06-30" \  -H "Authorization: Bearer YOUR_API_KEY"

Unduh CSV atau Parquet

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

bash · Plus / Pro · 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" \  -H "Authorization: Bearer YOUR_API_KEY" \  --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. Cakupan intraday 1m hingga 1h: 221 pasangan unik, yaitu 143 pasangan USD dan 78 pasangan silang.

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
1m221
5m221
15m221
1h221
4h209
1d10296
curl · Pro · 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" \  -H "Authorization: Bearer YOUR_API_KEY"

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.

Rincian cakupan dan batas

API nilai tukar intrahari