---
title: "Geçmiş döviz kurları ve zaman serileri"
description: "Birden fazla para biriminin geçmişini almak için /v1/range kullanın ve veriyi pandas’a aktarın."
canonical: "https://exchangerate.dev/tr/learn/historical-fx-time-series"
---

# Geçmiş döviz kurları ve zaman serileri

Birden fazla para biriminin geçmişini almak için /v1/range kullanın ve veriyi pandas’a aktarın.

1 Eki 2026 · 6 dk okuma

Aralık, sayfalama, kaynak ve doldurma işaretiyle kaydedilmiş gözlemleri döndürür.

- JSON sayfası en fazla 366 gözlem içerir. has_more true olduğu sürece next_cursor ile devam edin.
- Free: 30 gün; Basic: 1 yıl; Plus ve Pro: tam geçmiş. İstek başına en fazla 1.830 gün; derinlik pariteye bağlıdır.
- 13 Haziran 2026 Cumartesi yoktur; aralık her takvim günü için satır uydurmaz.
- Hayır. Gösterge değerleridir; notice ve source alanlarını inceleyin.

## Range endpoint’ini kullanın

start_date ve end_date iki ucu da içerir. base varsayılan olarak USD’dir; symbols virgülle ayrılır. İngilizce tarih aracı da vardır.

data kaydedilmiş satırları içerir. has_more ve next_cursor kullanın; CSV ve Parquet desteklenen pencereyi kapsar.

```getvrange title="GET /v1/range"
$ curl -G "https://api.exchangerate.dev/v1/range" \
    -H "Authorization: Bearer exr_live_..." \
    --data-urlencode "base=USD" \
    --data-urlencode "symbols=EUR,GBP" \
    --data-urlencode "start_date=2026-06-10" \
    --data-urlencode "end_date=2026-06-13"
```

## JSON yanıtını okuyun

data kaydedilmiş satırları içerir. has_more ve next_cursor kullanın; CSV ve Parquet desteklenen pencereyi kapsar.

```json
{
  "result": "success",
  "base": "USD",
  "start_date": "2026-06-10",
  "end_date": "2026-06-13",
  "data": [
    { "date": "2026-06-10", "rates": { "EUR": 0.86663, "GBP": 0.74727 },
      "source": "ecb_daily", "is_forward_filled": false },
    { "date": "2026-06-11", "rates": { "EUR": 0.86678, "GBP": 0.74829 },
      "source": "ecb_daily", "is_forward_filled": false },
    { "date": "2026-06-12", "rates": { "EUR": 0.86453, "GBP": 0.74613 },
      "source": "ecb_daily", "is_forward_filled": false }
  ],
  "has_more": false,
  "next_cursor": null
}
```

## Eksik takvim günleri

13 Haziran 2026 Cumartesi yoktur; aralık her takvim günü için satır uydurmaz.

## Python ile sayfalama

Bu döngü her imleci takip eder.

```pythonrequests title="Python · requests"
import requests

API = "https://api.exchangerate.dev/v1"
KEY = "exr_live_..."   # Basic or higher: https://exchangerate.dev/pricing

params = {
    "base": "USD",
    "symbols": "EUR,GBP",
    "start_date": "2026-06-10",
    "end_date": "2026-06-13",
}

rows = []
while True:
    resp = requests.get(
        f"{API}/range",
        headers={"Authorization": f"Bearer {KEY}"},
        params=params,
        timeout=10,
    )
    resp.raise_for_status()
    data = resp.json()
    rows.extend(data["data"])
    if not data["has_more"]:
        break
    cursor = data.get("next_cursor")
    if not cursor or cursor <= params.get("cursor", ""):
        raise RuntimeError("Incomplete historical response")
    params["cursor"] = cursor

for row in rows:
    filled = row["is_forward_filled"]
    print(row["date"], row["rates"]["EUR"], row["rates"]["GBP"], "filled" if filled else "")
```

## Gözlem ve taşınan değeri ayırın

Aralık gözlemlerinde is_forward_filled false olur; tarih sorgusu önceki değeri true işaretiyle döndürebilir.

**Hafta sonu bir gözlem değildir**

Aralık 13 Haziran 2026’yı atlar. Doğrudan tarih sorgusu önceki değeri is_forward_filled true ile döndürebilir.

## Tarih mi aralık mı

Tek tarih kontrol için, aralık grafik, backfill ve toplu analiz için uygundur.

| Boyut | Tarih | Aralık |
| --- | --- | --- |
| İstek | Her tarih için bir istek | Bir istek ve sayfalar |
| Yanıt | Bir gün | data dizisi |

## Kapsamı kontrol edin

Free: 30 gün; Basic: 1 yıl; Plus ve Pro: tam geçmiş. İstek başına en fazla 1.830 gün; derinlik pariteye bağlıdır.

## pandas

pandas’a yükleyin, tarihe göre sıralayın ve hesap öncesi taşınan değerleri çıkarın.

```pythonpandas title="Python · pandas"
import pandas as pd

# rows contains every page from the loop above
df = pd.json_normalize(rows)
df["date"] = pd.to_datetime(df["date"])
df = df.set_index("date").sort_index()

# keep only rows that were actually published that day
df = df[~df["is_forward_filled"]]

print(df[["rates.EUR", "rates.GBP"]].tail())
```

pandas zorunlu değildir; aynı satırlar başka araçlarla da işlenebilir.

[Geçmiş kur aracında bir tarih sorgulayın (İngilizce)](https://exchangerate.dev/historical-exchange-rates)

## Sorular

### Tarih biçimi nedir?

YYYY-MM-DD kullanın; aralık iki ucu da içerir.

### Tek para birimi nasıl alınır?

symbols=EUR kullanın, çokluları virgülle ayırın.

### Hafta sonu ve tatillerde ne olur?

Aralık eksik satır üretmez; tarih sorgusu önceki değeri döndürebilir.

### Kur takas için kullanılabilir mi?

Hayır. Gösterge değerleridir; notice ve source alanlarını inceleyin.

## Okumaya devam edin

- [Python ile döviz kuru alma](https://exchangerate.dev/tr/learn/python-exchange-rates)

Source: https://exchangerate.dev/tr/learn/historical-fx-time-series
