---
title: "Nilai tukar historis | exchangerate.dev"
description: "Tanggal di path atau `/v1/range`: Plus/Pro sejak 1999-01-04, Basic 1 tahun, tanpa key 30 hari."
canonical: "https://exchangerate.dev/id/docs/historical"
---

# 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 title="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 title="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 title="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.

| interval | Pasangan unik |
| --- | --- |
| `1m` | 221 |
| `5m` | 221 |
| `15m` | 221 |
| `1h` | 221 |
| `4h` | 209 |
| `1d` | 10296 |

```bash title="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](https://exchangerate.dev/id/docs/api-reference#timeseries)

[API nilai tukar intrahari](https://exchangerate.dev/id/intraday-exchange-rate-api)

Source: https://exchangerate.dev/id/docs/historical
