Makro seriler

Resmî Türkiye makro serileri — politika faizi, para piyasası faizleri, enflasyon beklentileri, yurt dışı yerleşik portföy akımları, rezervler, TÜFE, Yİ-ÜFE alt endeksleri, kapasite kullanım oranı ve reel kesim güveni — her gözlem resmî yayım zamanıyla; böylece geçmişteki herhangi bir anda neyin bilindiğini sorabilirsiniz. Ayrıca 2020'den bu yana tüm TCMB Para Politikası Kurulu (PPK) toplantıları. Tek kapsam, her planda dahil.

Uç noktalar

Uç noktaKapsamAçıklama
GET/v1/macro/seriescalendar:readSeri kataloğu: anahtar, başlık, frekans, birim, kaynak kodları, yayım kuralı, geçmiş başlangıcı ve seri kırılımları
GET/v1/macro/series/{key}?from=&to=&as_of=&revisions=calendar:readTek bir serinin gözlemleri, referans döneme göre kronolojik — pencere, zaman noktası okuması, revizyonlar
GET/v1/macro/ppk?from=&to=calendar:read2020'den bu yana tüm PPK toplantıları, sabit bırakılan kararlar ve ara toplantılar dahil

Deneme Alanı'nda deneyin →

Zaman noktası: released_at, as_of ve vintage

Her gözlem released_at taşır — o değerin resmî yayım anı (UTC); TÜİK Ulusal Veri Yayımlama Takvimi'nden ya da sabit bir kuraldan gelir; bilinmiyorsa null'dır, asla tahmin edilmez. first_seen_at, toplayıcımızın değeri ilk gördüğü andır. Sonraki bir revizyon revised_at ile yeni bir satır olarak saklanır; önceki satır silinmez.

as_of “o anda ne biliniyordu” sorusunu yanıtlar: bir satır yalnızca as_of anında ya da öncesinde yayımlanmışsa döner (canlı yakaladığımız satırlarda released_at ile first_seen_at'in geç olanı). Her referans dönem için bu koşulu sağlayan en yeni satır kazanır; revisions=true ise tüm satırları döndürür. Yayım zamanı bilinmeyen satırlar as_of okumalarına girmez — gelecekten bir değer yerine boşluk tercih edilir.

vintage satırın nasıl üretildiğini söyler: live (yayımlandığı sırada toplayıcımız yakaladı) ya da backfill_latest (geçmişten yüklendi).

Backfill uyarısı: backfill_latest satırları doğru yayım zamanını taşır, ancak değerleri backfill anında yayımlanmış en güncel değerdir — resmî kaynak eski sürümleri (vintage) tutmaz — dolayısıyla ilk yayımından bu yana revize edilmiş olabilir. Backfill edilmiş geçmişte as_of bir rakamın NE ZAMAN bilindiğini söyler; ilk açıklanan rakamın birebir kendisini değil. Mevsimsellikten arındırılmış anket serileri (capacity_utilization_sa, real_sector_confidence_sa) geriye doğru en çok revize olanlardır; ilk açıklanan değere sadakat önemliyse ham karşılığını kullanın.

Yayım kuralları ve kapsam notları

  • Günlük faizler (policy_rate, funding_cost, tlref) ertesi takvim günü 07:00 UTC ile damgalanır — ertesi sabah yayımlanan gün sonu rakamları için temkinli bir zaman.
  • Aylık ve haftalık serilerin çoğu, referans dönem bittikten sonra TÜİK Ulusal Veri Yayımlama Takvimi'ndeki ilk eşleşen yayımı alır. Kapasite kullanım oranı ve reel kesim güveni kendi referans ayının içinde yayımlanan anketlerdir (eylül verisi eylülde); bu yüzden released_at referans ayın içine düşer.
  • cpi ve core_cpi_c 2014-01'den başlar — yayım zamanı güvenilir biçimde çözülebilen ilk ay. İkisi de 2025=100 bazındadır, 2026 öncesi geriye hesaplanmıştır (2026-01'de series_break).
  • Piyasa Katılımcıları Anketi (pka_*) serilerinin henüz released_at'i yok; bu yüzden as_of okumaları onları atlar, düz okumalar tüm geçmişi döndürür. Bundan sonraki canlı yakalamalar first_seen_at ile damgalanacak.
  • series_break bir tanım ya da baz değişikliğini işaretler (katalogdaki breaks alanına bakın) — bu noktanın iki yakası arasında fark almayın. Yİ-ÜFE genel endeksi burada değil, /v1/inflation/yi-ufe üzerinden sunulur.

Sorgu parametreleri — /v1/macro/series/{key}

AlanTürNotlar
fromstring (YYYY-MM-DD)Bu günde ya da sonrasında başlayan referans dönemler, YYYY-MM-DD (YYYY-MM 422 ile reddedilir). Aylık dönem ayın 1'inde, çeyrek ilk gününde başlar.
tostring (YYYY-MM-DD)Bu günde ya da öncesinde başlayan referans dönemler, YYYY-MM-DD. from'dan önceki bir to 400'dür.
as_ofstringZaman noktası okuması: yalnızca bu anda bilinebilen değerler. YYYY-MM-DD o UTC gününün sonu (23:59:59Z) demektir; ya da bölgeli bir ISO-8601 anı (bölge yoksa 422).
revisionsbooltrue, revizyonlar dahil saklanan tüm satırları döndürür. Varsayılan false: her referans dönem için en yeni değer.

/v1/macro/ppk, toplantı tarihi üzerinde from / to (YYYY-MM-DD) alır.

Seriler

Katalogda şu anda 40 seri var. Güncel kaynak GET /v1/macro/series'tir (kodlar, yayım kuralı, kırılımlar); birim ve frekans API'nin döndürdüğü gibi gösterilir.

anahtarfrekansbirimbaşlangıçseri
Politika faizi ve para piyasasıreleased_at: ertesi takvim günü 07:00 UTC
policy_ratedaily%2020-01TCMB politika faizi (1 haftalık repo)
funding_costdaily%2020-01TCMB ağırlıklı ortalama fonlama maliyeti (politika faizinden sapabilir)
tlrefdaily%2020-01BIST TLREF gecelik referans faiz
Piyasa Katılımcıları Anketi (PKA)released_at: henüz yok (null) — as_of okumalarına girmez
pka_cpi_current_monthmonthly%2013-01Cari ayın aylık TÜFE beklentisi
pka_cpi_next_monthmonthly%2013-011 ay sonrasının aylık TÜFE beklentisi
pka_cpi_year_endmonthly%2013-01Cari yıl sonu yıllık TÜFE beklentisi
pka_cpi_12mmonthly%2013-0112 ay sonrası yıllık TÜFE beklentisi
pka_cpi_24mmonthly%2013-0124 ay sonrası yıllık TÜFE beklentisi
pka_policy_rate_nextmonthly%2013-01Politika faizi beklentisi — 2025-05'e kadar ay sonu 1 haftalık repo, 2025-06'dan ilk toplantı (2025-06'da seri kırılımı)
pka_policy_rate_meeting2monthly%2013-01İkinci toplantı politika faizi beklentisi (2025-06'dan)
pka_policy_rate_meeting3monthly%2013-01Üçüncü toplantı politika faizi beklentisi (2025-06'dan)
Yurt dışı yerleşik portföy akımları (haftalık, cuma referanslı)released_at: TÜİK yayım takvimi (menkul kıymet istatistikleri)
foreign_flows_equityweeklyUSD mn2020-01Yurt dışı yerleşikler: hisse senedi net değişim
foreign_flows_gddsweeklyUSD mn2020-01Yurt dışı yerleşikler: DİBS (kesin alım) net değişim
foreign_flows_totalweeklyUSD mn2020-01Yurt dışı yerleşikler: toplam net değişim
Rezervlerreleased_at: TÜİK yayım takvimi (haftalık para ve banka, analitik bilanço, rezervler ve döviz likiditesi)
reserves_grossweeklyUSD mn2020-01TCMB brüt rezervler (altın + döviz)
reserves_goldweeklyUSD mn2020-01TCMB rezervleri: altın
reserves_fxweeklyUSD mn2020-01TCMB rezervleri: döviz
reserves_netdailyUSD mn2020-01Analitik bilançodan net rezerv: (dış varlıklar − toplam döviz yükümlülükleri) ÷ USD alış kuru
irdl_reserve_assetsmonthlyUSD mn2013-01Rezervler ve döviz likiditesi: resmî rezerv varlıkları
irdl_fx_drainsmonthlyUSD mn2013-01Rezervler ve döviz likiditesi: döviz kredileri, menkul kıymet ve mevduat çıkışları
irdl_fwd_shortmonthlyUSD mn2013-01Rezervler ve döviz likiditesi: forward/futures açık pozisyonlar (swaplar dahil)
irdl_fwd_longmonthlyUSD mn2013-01Rezervler ve döviz likiditesi: forward/futures fazla pozisyonlar
Tüketici fiyatları ve reel kurreleased_at: TÜİK yayım takvimi
cpimonthlyindex (2025=100)2014-01TÜFE genel; 2025=100, 2026 öncesi geriye hesaplanmış (2026-01'de seri kırılımı)
core_cpi_cmonthlyindex (2025=100)2014-01Çekirdek TÜFE (C); 2025=100, 2026 öncesi geriye hesaplanmış (2026-01'de seri kırılımı)
reer_cpimonthlyindex (2025=100)2013-01TÜFE bazlı reel efektif döviz kuru
Yurt içi ÜFE (Yİ-ÜFE) alt endeksleri — yenireleased_at: TÜİK yayım takvimi (Yİ-ÜFE)
ppi_miningmonthlyindex (2003=100)2013-01Madencilik ve taşocakçılığı (B)
ppi_manufacturingmonthlyindex (2003=100)2013-01İmalat (C)
ppi_foodmonthlyindex (2003=100)2013-01Gıda ürünleri (C10)
ppi_coke_refined_petroleummonthlyindex (2003=100)2013-01Kok ve rafine petrol ürünleri (C19)
ppi_chemicalsmonthlyindex (2003=100)2013-01Kimyasallar ve kimyasal ürünler (C20)
ppi_rubber_plasticsmonthlyindex (2003=100)2013-01Kauçuk ve plastik ürünler (C22)
ppi_non_metallic_mineralsmonthlyindex (2003=100)2013-01Diğer metalik olmayan mineral ürünler, çimento dahil (C23)
ppi_basic_metalsmonthlyindex (2003=100)2013-01Ana metaller (C24)
ppi_electrical_equipmentmonthlyindex (2003=100)2013-01Elektrikli teçhizat (C27)
ppi_motor_vehiclesmonthlyindex (2003=100)2013-01Motorlu kara taşıtları, römork ve yarı römork (C29)
ppi_electricity_gasmonthlyindex (2003=100)2013-01Elektrik, gaz, buhar ve iklimlendirme (D)
Reel kesim anketleri — yenireleased_at: referans ayın içinde yayımlanır (TÜİK yayım takvimi)
capacity_utilization_samonthly%2013-01İmalat sanayi kapasite kullanım oranı, mevsimsellikten arındırılmış
capacity_utilizationmonthly%2013-01İmalat sanayi kapasite kullanım oranı, ham
real_sector_confidence_samonthlyindex2013-01Reel kesim güven endeksi, mevsimsellikten arındırılmış (100 = nötr)
real_sector_confidencemonthlyindex2013-01Reel kesim güven endeksi, ham (100 = nötr)

Örnekler

2026-10-05'te yayımlanan son Yİ-ÜFE motorlu kara taşıtları verisi:

curl (scope: calendar:read)
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/macro/series/ppi_motor_vehicles?from=2026-09-01"
response (excerpt)
{
  "series": {
    "key": "ppi_motor_vehicles",
    "title": "Yİ-ÜFE: motorlu kara taşıtları, römork ve yarı römork (C29)",
    "frequency": "monthly",
    "unit": "index (2003=100)",
    "release_rule": "tuik:Yurt İçi Üretici Fiyat Endeksi|Üretici Fiyatları Endeksi",
    "source_codes": ["TP.TUFE1YI.T105"],
    "start": "2013-01-01",
    "breaks": []
  },
  "as_of": null,
  "items": [
    {
      "ref_period": "2026-09",
      "value": "3693.79",
      "released_at": "2026-10-05T07:00:00Z",
      "first_seen_at": "…",
      "revised_at": null,
      "vintage": "…",
      "series_break": null
    }
  ],
  "count": 1
}

Belirli bir günde ne biliniyordu

as_of ile bir ay ancak yayım zamanı geçtikten sonra görünür. İlk TÜFE satırı 2014-01'dir, 2014-02-03 07:00 UTC'de yayımlandı:

curl — as_of
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/macro/series/cpi?from=2013-01-01&to=2014-03-31&as_of=2014-02-03"
response (excerpt)
{
  "series": { "key": "cpi", "frequency": "monthly", "unit": "index (2025=100)", … },
  "as_of": "2014-02-03T23:59:59Z",
  "items": [
    {
      "ref_period": "2014-01",
      "value": "…",
      "released_at": "2014-02-03T07:00:00Z",
      "first_seen_at": null,
      "revised_at": null,
      "vintage": "backfill_latest",
      "series_break": null
    }
  ],
  "count": 1
}

PPK toplantıları

curl — PPK
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/macro/ppk?from=2025-01-01"
response (shape)
{
  "items": [
    {
      "meeting_date": "YYYY-MM-DD",
      "type": "scheduled",
      "decision_time": "YYYY-MM-DDT11:00:00Z",
      "rate_before": "…",
      "rate_after": "…",
      "change_bp": 0,
      "statement_url": "…",
      "summary_date": "…",
      "summary_url": "…"
    }
  ],
  "count": "…"
}

Yanıt alanları

AlanTürNotlar
seriesobjectSerinin katalog kaydı (key, title, frequency, unit, release_rule, source_codes, start, breaks).
as_ofstring | nullas_of sınırının yankısı (UTC'ye normalize), ya da null.
items[].ref_periodstringReferans dönem: YYYY-MM-DD (günlük, haftalık), YYYY-MM (aylık) ya da YYYY-Qn (çeyreklik).
items[].valuestring | nullTam ondalık metin; float değil, ondalık olarak ayrıştırın. Kaynak vermediyse null.
items[].released_atstring | nullResmî yayım anı (UTC); bilinmiyorsa null.
items[].first_seen_atstring | nullToplayıcımızın değeri ilk gördüğü an (UTC); backfill satırlarında null.
items[].revised_atstring | nullSatır bir revizyonsa dolu.
items[].vintagestringlive ya da backfill_latest (yukarıya bakın).
items[].series_breakstring | nullTanım/baz değişikliğinin başladığı dönemde dolu.

PPK satırları: meeting_date, type (scheduled | interim), decision_time (UTC; olağan toplantılarda 14:00 TSİ, ara toplantılarda null), rate_before / rate_after (politika faizi, %), change_bp (0 = sabit), statement_url, summary_date, summary_url.

Hatalar

Hatalı from/to/as_of için 422, to from'dan önceyse 400, bilinmeyen seri anahtarı için 404 (mesaj /v1/macro/series'i gösterir). Seriler henüz yüklenmemişse uç noktalar hata değil, boş bir 200 döndürür.

Kapsam ve planlar

Üç uç nokta da calendar:read kapsamıyla korunur — ekonomik takvim ve enflasyon serisiyle paylaşılan makro/referans-verisi kapsamıdır ve her plana dahildir. İstek başına 1 birim ölçülür. Anahtarınız bu kapsamdan eskiyse geliştirici portalında anahtarı yeniden oluşturun (ya da kapsamı ekleyin).

Ayrıca bakınız: Enflasyon (Yİ-ÜFE) · ekonomik takvim · /docs/authentication