Ücretsiz Döviz ve Altın API’si

Uç noktalar

Taban adres: https://dolarkac.com. Yanıtlar Cache-Control: public, s-maxage=15 ile önbelleğe alınır.

Örnekler

curl

curl https://dolarkac.com/api/v1/prices
curl https://dolarkac.com/api/v1/prices/GRAM

JavaScript

const r = await fetch('https://dolarkac.com/api/v1/prices/USD');
if (r.ok) {
  const usd = await r.json();
  console.log(usd.name, usd.ask);
} else if (r.status === 429) {
  // Retry-After saniye kadar bekleyin
}

Örnek yanıt

{
  "source": "dolarkac.com",
  "attribution": "https://dolarkac.com",
  "attributionRequired": true,
  "attributionHtml": "Kaynak: <a href=\"https://dolarkac.com/\">Canlı döviz kurları – DolarKaç</a>",
  "terms": "https://dolarkac.com/gelistirici-api#kosullar",
  "id": "USD",
  "name": "Amerikan Doları",
  "bid": 49.913,
  "ask": 50,
  "last": 50,
  "changePct": 0.2868,
  "ts": 1793687049000
}

Alanlar

Fiyat bilinmiyorsa veya doğrulamadan geçmiyorsa ilgili alan null olur. TL varlıklar TL, ons ve paritelerin bir kısmı USD cinsindendir.

Durum kodları

• 200 Başarılı.
• 404 Bilinmeyen varlık kimliği.
• 429 İstek sınırı aşıldı (IP başına dakikada 60); Retry-After başlığına uyun. Kalan hak X-RateLimit-Remaining başlığındadır.
• 503 Veri akışı 15 dakikadan uzun süredir güncel değil; Retry-After sonra tekrar deneyin. Kısa duraklamalarda yanıt "stale": true içerir.

Kaynak gösterimi (zorunlu)

API verilerini gösterdiğiniz sayfada, verinin yanında veya altında tıklanabilir bir DolarKaç bağlantısı bulunmalıdır. Bağlantıyı nofollow, gizli ya da yalnızca görsel olarak eklemeyin. Her yanıttaki attributionHtml alanını doğrudan kullanabilirsiniz:

Kaynak: <a href="https://dolarkac.com/">Canlı döviz kurları – DolarKaç</a>

Kullanım koşulları

• API ücretsizdir; kişisel ve ticari sitelerde kullanılabilir.
• Verileri gösterdiğiniz her yerde dolarkac.com adresine görünür ve tıklanabilir bir kaynak bağlantısı zorunludur (örnek kod).
• Verilerin yeniden satışı, ücretli bir veri hizmeti olarak sunulması veya API’nin toplu kopyalanması yasaktır.
• İstisna: günlük kapanış verilerini içeren açık veri setimiz CC BY 4.0 lisansıyla yayımlanır; o veri seti, kaynak gösterilmesi şartıyla ticari amaçla da kullanılabilir.
• Fiyatlar bilgilendirme amaçlıdır, yatırım tavsiyesi değildir ve işlem fiyatı olarak kullanılmamalıdır.
• API, uç noktalar ve sınırlar önceden haber verilmeksizin değişebilir veya durdurulabilir. Genel koşullar için kullanım koşulları.

Kodsuz bir çözüm için canlı kur widget’ı veya uzun dönem grafik kullanabilirsiniz.

Varlık kimlikleri