İçeriğe geç / Skip to content
KKTC Döviz Kurları

Döviz Veri API'si

Bağımsız veri motorumuz üzerinde, sözleşmeli müşteriler için REST API.

Yakında
Henüz satışa açık değil. API yalnızca kurumun kurlarının API ile yeniden satılmasına yazılı izin verdiği kaynakları sunar; böyle bir kaynak olduğunda sözleşme ve fatura ile açılır. SLA yoktur.

Planlanan uç noktalar

  • GET /v1/institutionsPLANNED
  • GET /v1/rates/latest?base=GBP&channel=cashPLANNED
  • GET /v1/rates/best?base=GBP&action=sell_currencyPLANNED
  • GET /v1/rates/history?institution=<slug>&base=GBP&from=…&to=…PLANNED
  • GET /v1/sources/healthPLANNED

Yanıt zarfı

GET /v1/rates/latest?base=GBP
Authorization: Bearer <API key>

{
  "as_of": "<ISO-8601 time>",
  "data": [{
    "institution": "<slug>",
    "base": "GBP", "quote": "TRY", "channel": "cash",
    "buy": "<decimal, 4 dp>", "sell": "<decimal, 4 dp>",
    "freshness_status": "fresh | stale",
    "source_published_at": "<ISO-8601 time | null>",
    "observed_at": "<ISO-8601 time>",
    "redistribution_entitlement": "commercial_api_licensed"
  }]
}
X-Quota-Remaining / X-RateLimit-Remaining headers

İlkeler

  • Yalnızca kurumun yazılı ticari API lisansı verdiği kaynaklar sunulur; sitede gösterilmesi yeterli değildir.
  • Her yanıtta as_of, kaynak zamanı ve tazelik durumu bulunur.
  • Gerçek zamanlı veya resmi kur iddiası yapılmaz.
  • Anahtarlar sunucuda hash'lenerek saklanır; mobil uygulamaya gömülmez.