Dokümantasyon /

Geçmiş döviz kurları

Tek gün için tarih yolunu, günlük seri için `/v1/range` kullanın. Yayımlanmış veriler 1999-01-04 tarihinde başlar.

Tek tarih isteyin

Hafta sonu veya tatilde endpoint son yayımlanan fixing değerini döndürür ve `is_forward_filled` true olur. Yeni bir gözlem uydurulmaz.

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

Tarih aralığı isteyin

`symbols`, `start_date`, `end_date` gönderin. JSON sayfa başına en fazla 366 satır verir; `has_more` true ise `next_cursor` değerini sonraki çağrıya ekleyin.

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"

CSV veya Parquet indirin

`format=csv` ya da `format=parquet` ekleyin. Dosya tüm istenen aralığı içerir ve JSON cursor kullanmaz.

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

Kaynağı sayıyla birlikte saklayın

Her gözlemle `source`, `is_forward_filled`, `derived_symbols` alanlarını tutarsanız veriyi daha sonra açıklayabilirsiniz.

source · is_forward_filled · derived_symbols

Gün içi seriler ve kapsam

/v1/timeseries; 1m, 5m, 15m, 1h, 4h ve günlük referans verisi 1d aralıklarını destekler. 2h yoktur. USD içermeyen SGD çaprazları 4h için desteklenmez; USD/SGD ve tersi desteklenir. Piyasa verileri 2026-09-14 tarihinde toplanmaya başladı. 1m verileri 30 gün tutulur; daha büyük aralıklar için planlı silme süresi yoktur. Saklama süresi, o kadar geçmişin zaten biriktiği anlamına gelmez.

Geçmiş çaprazlar aynı UTC aralığındaki gerçek kapanış gözlemlerini kullanır; zaman farkı en fazla 5 saniyedir. effective_at daha eski gözlemin zamanıdır. Boşluklar doldurulmaz; açık aralık değişebilir. 1d tüm katalog için günlük referans verisidir. Tablo benzersiz pariteleri sayar; iki yön de desteklenir.

intervalBenzersiz pariteler
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"

Desteklenen bir zaman penceresinde gözlem yoksa HTTP 200 ile data: [], has_more: false ve next_cursor: null döner. Bilinmeyen aralık unsupported_interval; kapsam dışı parite unsupported_pair_interval ve rejected_pairs döndürür (HTTP 400). Karma istekler bütünüyle reddedilir.

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

Kapsam ve limit ayrıntıları

Gün içi döviz kuru API’si