Core Exchange API

TCMB döviz kuru mikro servisi · Ana Sayfa

Genel Kurlar Çevrim Çapraz Kurlar Yönetim WebSocket Sağlık

Genel Bilgiler

Tüm yanıtlar aşağıdaki formatta döner:

{
  "success": true | false,
  "data": { ... } | null,
  "error": "Hata mesajı" | null,
  "timestamp": "2026-02-17T08:00:00.000Z"
}

TCMB kurları her iş günü saat 15:30'da açıklanır. Servis bu kurları 15:45'te otomatik çeker. Her gün bir önceki günün açıklaması geçerlidir. Tatil ve hafta sonlarında en son açıklanan kur kullanılır.

Temel URL

https://exchange.coreit.tr

Desteklenen Para Birimleri

Yükleniyor...

TRY (Türk Lirası) çevrim işlemlerinde kaynak veya hedef olarak kullanılabilir. Liste TCMB verilerine göre otomatik güncellenir.

Döviz Kurları

GET /api/rates/today

Bugün için geçerli olan döviz kurlarını döner. İsteğe bağlı tarih parametresi ile geçmiş bir güne ait kurlar sorgulanabilir.

Parametre	Tür	Açıklama
date	query opsiyonel	YYYY-MM-DD formatında tarih. Verilmezse bugünün kurları döner.

GET /api/rates/today
GET /api/rates/today?date=2026-02-14

GET /api/rates/announcement/:date

Belirtilen tarihte TCMB tarafından yapılan açıklamaya ait kurları döner.

Parametre	Tür	Açıklama
:date	path zorunlu	YYYY-MM-DD formatında açıklama tarihi.

GET /api/rates/announcement/2026-02-14

GET /api/rates/range

Belirtilen tarih aralığındaki tüm kurları döner.

Parametre	Tür	Açıklama
from	query zorunlu	Başlangıç tarihi (YYYY-MM-DD)
to	query zorunlu	Bitiş tarihi (YYYY-MM-DD)

GET /api/rates/range?from=2026-02-10&to=2026-02-14

GET /api/rates/currency/:code

Belirtilen para birimine ait güncel kuru döner.

Parametre	Tür	Açıklama
:code	path zorunlu	3 harfli para birimi kodu (örn. USD, EUR)
date	query opsiyonel	YYYY-MM-DD formatında tarih.

GET /api/rates/currency/USD
GET /api/rates/currency/EUR?date=2026-02-14

GET /api/rates/currency/:code/history

Belirtilen para biriminin tarih aralığındaki kur geçmişini döner.

Parametre	Tür	Açıklama
:code	path zorunlu	3 harfli para birimi kodu
from	query zorunlu	Başlangıç tarihi (YYYY-MM-DD)
to	query zorunlu	Bitiş tarihi (YYYY-MM-DD)

GET /api/rates/currency/USD/history?from=2026-01-01&to=2026-02-17

GET /api/rates/currencies

Desteklenen tüm para birimi kodlarının listesini döner.

GET /api/rates/currencies

Döviz Çevirici

GET /api/convert

İki para birimi arasında çevrim yapar. TRY kaynak veya hedef olarak kullanılabilir.

Parametre	Tür	Açıklama
from	query zorunlu	Kaynak para birimi (örn. USD, TRY)
to	query zorunlu	Hedef para birimi (örn. EUR, TRY)
amount	query zorunlu	Çevrilecek tutar (pozitif sayı)
date	query opsiyonel	YYYY-MM-DD formatında tarih
rateType	query opsiyonel	`forex` (varsayılan) veya `banknote`

GET /api/convert?from=USD&to=TRY&amount=100
GET /api/convert?from=EUR&to=USD&amount=500&rateType=banknote
GET /api/convert?from=TRY&to=GBP&amount=10000&date=2026-02-14

Çapraz Kurlar

GET /api/convert/cross-rates

Tüm veya seçili para birimleri arasındaki çapraz kur tablosunu döner.

Parametre	Tür	Açıklama
currencies	query opsiyonel	Virgülle ayrılmış para birimi kodları (örn. USD,EUR,GBP). Boş bırakılırsa tümü döner.
date	query opsiyonel	YYYY-MM-DD formatında tarih

GET /api/convert/cross-rates
GET /api/convert/cross-rates?currencies=USD,EUR,GBP

GET /api/convert/cross-rates/:base/:target

İki para birimi arasındaki çapraz kuru döner.

Parametre	Tür	Açıklama
:base	path zorunlu	Baz para birimi kodu
:target	path zorunlu	Hedef para birimi kodu
date	query opsiyonel	YYYY-MM-DD formatında tarih

GET /api/convert/cross-rates/USD/EUR
GET /api/convert/cross-rates/GBP/JPY?date=2026-02-14

Yönetim

Yönetim endpoint'leri API anahtarı gerektirir. Anahtarı X-Api-Key header'ı veya api_key query parametresi ile gönderin.

POST /api/rates/fetch

TCMB'den bugünün kurlarını manuel olarak çeker ve veritabanına kaydeder.

POST /api/rates/fetch

POST /api/rates/backfill

Belirtilen tarih aralığı için geçmiş kurları TCMB'den çekip veritabanına kaydeder. Maksimum 365 gün.

Parametre	Tür	Açıklama
from	body zorunlu	Başlangıç tarihi (YYYY-MM-DD)
to	body zorunlu	Bitiş tarihi (YYYY-MM-DD)

POST /api/rates/backfill
Content-Type: application/json

{
  "from": "2025-11-17",
  "to": "2026-02-16"
}

WebSocket

WS /ws

Gerçek zamanlı kur güncellemeleri için WebSocket bağlantısı. Yeni kurlar açıklandığında bağlı tüm istemcilere bildirim gönderir.

ws://exchange.coreit.tr/ws
wss://exchange.coreit.tr/ws

Mesaj Türleri

CONNECTION_ACK — Bağlantı başarılı, istemci kimliği atandı.

RATES_UPDATED — Yeni kurlar yayınlandı. Açıklama tarihi, geçerlilik tarihi ve güncellenen para birimleri bilgisi içerir.

PING / PONG — Bağlantı canlılık kontrolü (30 saniye aralıkla).

ERROR — Hata mesajı.

{
  "type": "RATES_UPDATED",
  "data": {
    "announcementDate": "2026-02-17",
    "effectiveDate": "2026-02-18",
    "currencies": ["USD", "EUR", "GBP", "..."],
    "rateCount": 21 // Dinamik, TCMB verisine göre değişir
  },
  "timestamp": "2026-02-17T12:45:01.000Z"
}

Maksimum 100 eşzamanlı WebSocket bağlantısı desteklenir.

Sağlık Kontrolü

GET /api/health

Servisin sağlık durumunu döner. Veritabanı bağlantısı, önbellek durumu, çalışma süresi ve WebSocket istemci sayısını içerir.

GET /api/health

{
  "success": true,
  "data": {
    "status": "healthy",
    "uptime": 3600,
    "database": "connected",
    "lastFetch": "2026-02-17",
    "cacheLoaded": true,
    "wsClients": 2,
    "version": "1.0.0"
  }
}

status değeri: healthy (her şey çalışıyor, HTTP 200) veya degraded (veritabanı bağlantısı yok, HTTP 503).