Ekonomi

Ücretsiz Döviz Kuru API (JSON/XML) — Dolar, Euro, Altın

Doğuş Şekerci · 14 Haziran 2026 · 4 dk okuma

Sitenize döviz kurlarını ekleyin: ücretsiz JSON/XML döviz kuru API. Dolar, euro, gram altın kurları TL bazlı. cURL, PHP, JavaScript ve Python örnek kodları.

Ücretsiz Döviz Kuru API (JSON/XML) — Dolar, Euro, Altın

Web sitenize veya uygulamanıza canlı döviz kurları eklemek mi istiyorsunuz? DolarToday; dolar, euro, sterlin ve gram altın kurlarını ücretsiz JSON/XML döviz kuru API ile sunuyor. Tüm uçlar basit bir GET isteğiyle çalışır ve varsayılan olarak JSON döner. Bu rehberde uç noktaları, parametreleri ve cURL, PHP, JavaScript, Python örnek kodlarını bulacaksınız.

👉 Resmi dokümantasyon: DolarToday Kur API sayfası

Genel Bakış

API'nin temel mantığı şöyledir:

Tüm uçlar GET isteğiyle çalışır ve varsayılan olarak JSON döner.
XML almak için ?format=xml parametresini ekleyin veya Accept: application/xml başlığını gönderin.
Kurlar TL bazlıdır (base = TRY); değerler 1 birim = X TL biçimindedir.
Hız limiti: IP başına dakikada 120 istek.

Neden DolarToday Kur API?

Tamamen ücretsiz: Gizli ücret yok, kredi kartı istenmez.
Cömert hız limiti: IP başına dakikada 120 istek; normal kullanım için fazlasıyla yeterli.
JSON ve XML desteği: Tek parametreyle format değiştirilir.
TCMB veya serbest piyasa: source parametresiyle istediğiniz kaynağı seçersiniz.
Anlık güncel veri: Kurlar gün içinde sürekli güncellenir.

Uç Noktalar

Method	Uç Nokta	Açıklama
GET	`/api/rates`	Tüm aktif kurlar
GET	`/api/rates/{kod}`	Tek kur (ör. `usd`, `eur`; gram altın için `GA`)
GET	`/api/rates?symbols=USD,EUR`	Seçili kurlar
GET	`/api/rates?source=tcmb`	Resmi TCMB kuru
GET	`/api/rates?format=xml`	XML çıktı

Parametreler

Parametre	Açıklama
`symbols`	Virgülle ayrılmış kodlar: `USD,EUR,GBP`
`source`	`serbest` (varsayılan) veya `tcmb`
`format`	`json` (varsayılan) veya `xml`

Örnek Yanıt (JSON)

GET /api/rates/usd isteğine dönen yanıt:

{
  "success": true,
  "base": "TRY",
  "updated_at": "2026-06-12T15:30:00+03:00",
  "rate": {
    "code": "USD",
    "name": "Amerikan Doları",
    "type": "forex",
    "buy": 46.0857,
    "sell": 46.1688,
    "change_pct": 0,
    "source": "tcmb",
    "updated_at": "2026-06-12T15:30:00+03:00"
  }
}

Yanıttaki buy alış, sell satış fiyatını; change_pct günlük yüzde değişimi; base ise kurların TL bazlı olduğunu gösterir.

Hızlı Başlangıç

cURL

curl "https://dolartoday.org/api/rates?symbols=USD,EUR"

JavaScript (Fetch)

const r = await fetch("https://dolartoday.org/api/rates/usd");
const data = await r.json();
console.log(data.rate.sell);

PHP

<?php
$json  = file_get_contents("https://dolartoday.org/api/rates");
$rates = json_decode($json, true)["rates"];
 
echo "Dolar Satış: " . $rates["USD"]["sell"] . " TL";
?>

Python

import requests
 
data = requests.get("https://dolartoday.org/api/rates/usd").json()
print("Dolar Satış:", data["rate"]["sell"])

JSON mu XML mi Kullanmalı?

Modern web ve mobil projelerde genellikle JSON tercih edilir; hafiftir ve JavaScript ile doğal uyumludur. Eski sistemler veya kurumsal entegrasyonlar için ?format=xml ile XML çıktı alabilir ya da Accept: application/xml başlığını gönderebilirsiniz.

Hız Limitini Aşmamak İçin İpuçları

IP başına dakikada 120 istek çoğu proje için yeterlidir. Yüksek trafikli sitelerde limiti zorlamamak için:

Kur verisini sunucunuzda kısa süreli önbelleğe alın (ör. 30–60 saniye) ve ziyaretçilere bu önbellekten sunun.
Her sayfa yüklenişinde değil, zamanlanmış bir görevle (cron) belirli aralıklarla veri çekin.
Yalnızca ihtiyacınız olan kurları ?symbols= ile isteyin.

Başlarken

API'yi kullanmaya başlamak için kur API sayfasını ziyaret edin. Kurları sitenizde göstermeden önce canlı değerleri dolar ve euro sayfalarımızdan doğrulayabilir, hesaplama için döviz çeviriciyi kullanabilirsiniz.

Sıkça Sorulan Sorular

Döviz kuru API ücretsiz mi?

Evet, DolarToday kur API'si ücretsizdir ve JSON/XML formatında veri sunar.

API'de hız limiti var mı?

Evet, IP başına dakikada 120 istek. Önbellekleme ile bu limit kolayca yönetilir.

Kurlar hangi para birimi bazında?

Tüm kurlar TL bazlıdır (base = TRY); değerler "1 birim = X TL" biçiminde döner.

TCMB ile serbest piyasa kurunu nasıl seçerim?

source=tcmb resmi kuru, varsayılan source=serbest ise serbest piyasa kurunu döndürür.

Doğuş Şekerci

Editör