Döviz ve kur çevrimi

65 döviz paritesi — TRY bacakları, G10 majörleri ve çaprazları, gelişen piyasa egzotikleri — 15 dakika gecikmeli; artı herhangi bir fiyatlı yanıtı TRY, USD veya EUR'ya çeviren ?currency= parametresi.

Uç noktalar

Uç nokta	Kapsam	Açıklama
GET/v1/quotes/fx:{PAIR}	fx	Tek parite fiyatı (toplu: GET /v1/quotes?ids=…, ≤100 kimlik)
GET/v1/instruments?market=fx	any key	65 paritelik tam katalog — isimler ve kotasyon para birimleri
GET/v1/candles/fx:{PAIR}?resolution=5m\|1d	history	Gün içi 5dk (yaklaşık son 7 gün) veya günlük barlar
GET/v1/eod/fx:{PAIR}?from=&to=	history	Gün sonu kayıtları

Deneme Alanı'nda deneyin →

Kapsam: 65 parite

Tüm TRY bacakları (USDTRY, EURTRY, GBPTRY, JPYTRY, CHFTRY, CADTRY, CNHTRY, RUBTRY, AEDTRY, ZARTRY), G10 majörleri ve çaprazları (EURUSD, GBPUSD, USDJPY, GBPJPY, EURGBP, AUDNZD, …) ve gelişen piyasa pariteleri (USDMXN, USDBRL, USDKRW, USDINR, USDZAR, …). Tam listeyi — her paritenin kotasyon para birimiyle birlikte — katalogdan çekin:

curl — the full FX catalog

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/instruments?market=fx&limit=100"

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/quotes/fx:GBPJPY"

response

{
  "instrument_id": "fx:GBPJPY",
  "symbol": "GBPJPY",
  "market": "fx",
  "currency": "JPY",
  "last": "216.7075",
  "prev_close": null,
  "change": "-0.05249023",
  "change_pct": "-0.02421583",
  "open": "216.75", "high": "217.06", "low": "216.46",
  "bid": "216.701", "ask": "216.714",
  "volume": null, "turnover": null,
  "as_of": "2026-08-21T10:53:30.598000Z",
  "data_delay_seconds": 900
}

Bir parite ikinci ayağı üzerinden fiyatlanır

Yanıttaki currency paritenin ikinci ayağıdır: fx:GBPJPY için currency: "JPY" döner. Asla TRY varsaymayın.

Seyrek satırlar dürüst satırlardır

Döviz satırları, akışın gerçekten gönderdiği alanlardan oluşur. Kaynağın iletmediği bir alan (önceki kapanış, hacim) null olur; sıfır ya da tahmin değil — yukarıdaki GBPJPY örneği bunu gösterir. Tazelik as_of değerinin söylediğidir: kaynağın kendi gözlem zamanı.

7/24 kayıt, günlük geçmiş 2020'den itibaren

Serbest piyasa akışı hafta sonları dahil gün boyu fiyat verir; biz de 7/24 kaydederiz. Günlük bar 00:00 TRT itibarıyla kapanır (İstanbul saatiyle 00:00).

Döviz evreni için günlük barlar 2020-01-01 tarihine kadar uzanır (satıcı arşivinden geri dolduruldu; yalnız işlem günleri). 5 dakikalık gün içi barlar yaklaşık 7 günlük kayan bir pencereyi kapsar. Bir enstrümanın kapsam başlangıcından önceki boş bir aralık hata değil, doğru cevaptır — katalogdaki coverage_from alanı bu başlangıcı damgalar (65 paritenin tamamında 2020-01-01).

Herhangi bir fiyatlı uç noktada ?currency=

Fiyatlar, barlar ve gün sonu kayıtları ?currency=TRY|USD|EUR parametresini kabul eder. Fiyat ve değer alanları çevrilir; yüzdeler ve birim sayıları (hacim, işlem sayısı) asla çevrilmez. Çevrilen yanıtlar kullanılan kuru açıklar:

curl — THYAO in USD

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/quotes/bist:THYAO?currency=USD"

response (abridged)

{
  "instrument_id": "bist:THYAO",
  "currency": "USD",
  "last": "7.201158",
  "fx_rate": "0.021289",
  "fx_as_of": "2026-07-10T15:19:01Z",
  ...
}

Desteklenmeyen hedefler 422 döndürür; eksik bir kur ise 503 döndürür (asla bayat veya uydurma bir dönüşüm değil).