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ç nokta | Kapsam | Açıklama |
|---|---|---|
| GET/v1/macro/series | calendar:read | Seri 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:read | Tek bir serinin gözlemleri, referans döneme göre kronolojik — pencere, zaman noktası okuması, revizyonlar |
| GET/v1/macro/ppk?from=&to= | calendar:read | 2020'den bu yana tüm PPK toplantıları, sabit bırakılan kararlar ve ara toplantılar dahil |
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).
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}
| Alan | Tür | Notlar |
|---|---|---|
| from | string (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. |
| to | string (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_of | string | Zaman 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). |
| revisions | bool | true, 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.
| anahtar | frekans | birim | başlangıç | seri |
|---|---|---|---|---|
| Politika faizi ve para piyasasıreleased_at: ertesi takvim günü 07:00 UTC | ||||
| policy_rate | daily | % | 2020-01 | TCMB politika faizi (1 haftalık repo) |
| funding_cost | daily | % | 2020-01 | TCMB ağırlıklı ortalama fonlama maliyeti (politika faizinden sapabilir) |
| tlref | daily | % | 2020-01 | BIST 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_month | monthly | % | 2013-01 | Cari ayın aylık TÜFE beklentisi |
| pka_cpi_next_month | monthly | % | 2013-01 | 1 ay sonrasının aylık TÜFE beklentisi |
| pka_cpi_year_end | monthly | % | 2013-01 | Cari yıl sonu yıllık TÜFE beklentisi |
| pka_cpi_12m | monthly | % | 2013-01 | 12 ay sonrası yıllık TÜFE beklentisi |
| pka_cpi_24m | monthly | % | 2013-01 | 24 ay sonrası yıllık TÜFE beklentisi |
| pka_policy_rate_next | monthly | % | 2013-01 | Politika 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_meeting2 | monthly | % | 2013-01 | İkinci toplantı politika faizi beklentisi (2025-06'dan) |
| pka_policy_rate_meeting3 | monthly | % | 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_equity | weekly | USD mn | 2020-01 | Yurt dışı yerleşikler: hisse senedi net değişim |
| foreign_flows_gdds | weekly | USD mn | 2020-01 | Yurt dışı yerleşikler: DİBS (kesin alım) net değişim |
| foreign_flows_total | weekly | USD mn | 2020-01 | Yurt 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_gross | weekly | USD mn | 2020-01 | TCMB brüt rezervler (altın + döviz) |
| reserves_gold | weekly | USD mn | 2020-01 | TCMB rezervleri: altın |
| reserves_fx | weekly | USD mn | 2020-01 | TCMB rezervleri: döviz |
| reserves_net | daily | USD mn | 2020-01 | Analitik bilançodan net rezerv: (dış varlıklar − toplam döviz yükümlülükleri) ÷ USD alış kuru |
| irdl_reserve_assets | monthly | USD mn | 2013-01 | Rezervler ve döviz likiditesi: resmî rezerv varlıkları |
| irdl_fx_drains | monthly | USD mn | 2013-01 | Rezervler ve döviz likiditesi: döviz kredileri, menkul kıymet ve mevduat çıkışları |
| irdl_fwd_short | monthly | USD mn | 2013-01 | Rezervler ve döviz likiditesi: forward/futures açık pozisyonlar (swaplar dahil) |
| irdl_fwd_long | monthly | USD mn | 2013-01 | Rezervler ve döviz likiditesi: forward/futures fazla pozisyonlar |
| Tüketici fiyatları ve reel kurreleased_at: TÜİK yayım takvimi | ||||
| cpi | monthly | index (2025=100) | 2014-01 | TÜFE genel; 2025=100, 2026 öncesi geriye hesaplanmış (2026-01'de seri kırılımı) |
| core_cpi_c | monthly | index (2025=100) | 2014-01 | Çekirdek TÜFE (C); 2025=100, 2026 öncesi geriye hesaplanmış (2026-01'de seri kırılımı) |
| reer_cpi | monthly | index (2025=100) | 2013-01 | TÜ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_mining | monthly | index (2003=100) | 2013-01 | Madencilik ve taşocakçılığı (B) |
| ppi_manufacturing | monthly | index (2003=100) | 2013-01 | İmalat (C) |
| ppi_food | monthly | index (2003=100) | 2013-01 | Gıda ürünleri (C10) |
| ppi_coke_refined_petroleum | monthly | index (2003=100) | 2013-01 | Kok ve rafine petrol ürünleri (C19) |
| ppi_chemicals | monthly | index (2003=100) | 2013-01 | Kimyasallar ve kimyasal ürünler (C20) |
| ppi_rubber_plastics | monthly | index (2003=100) | 2013-01 | Kauçuk ve plastik ürünler (C22) |
| ppi_non_metallic_minerals | monthly | index (2003=100) | 2013-01 | Diğer metalik olmayan mineral ürünler, çimento dahil (C23) |
| ppi_basic_metals | monthly | index (2003=100) | 2013-01 | Ana metaller (C24) |
| ppi_electrical_equipment | monthly | index (2003=100) | 2013-01 | Elektrikli teçhizat (C27) |
| ppi_motor_vehicles | monthly | index (2003=100) | 2013-01 | Motorlu kara taşıtları, römork ve yarı römork (C29) |
| ppi_electricity_gas | monthly | index (2003=100) | 2013-01 | Elektrik, 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_sa | monthly | % | 2013-01 | İmalat sanayi kapasite kullanım oranı, mevsimsellikten arındırılmış |
| capacity_utilization | monthly | % | 2013-01 | İmalat sanayi kapasite kullanım oranı, ham |
| real_sector_confidence_sa | monthly | index | 2013-01 | Reel kesim güven endeksi, mevsimsellikten arındırılmış (100 = nötr) |
| real_sector_confidence | monthly | index | 2013-01 | Reel kesim güven endeksi, ham (100 = nötr) |
Örnekler
2026-10-05'te yayımlanan son Yİ-ÜFE motorlu kara taşıtları verisi:
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/macro/series/ppi_motor_vehicles?from=2026-09-01"{
"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 -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"{
"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 -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/macro/ppk?from=2025-01-01"{
"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ı
| Alan | Tür | Notlar |
|---|---|---|
| series | object | Serinin katalog kaydı (key, title, frequency, unit, release_rule, source_codes, start, breaks). |
| as_of | string | null | as_of sınırının yankısı (UTC'ye normalize), ya da null. |
| items[].ref_period | string | Referans dönem: YYYY-MM-DD (günlük, haftalık), YYYY-MM (aylık) ya da YYYY-Qn (çeyreklik). |
| items[].value | string | null | Tam ondalık metin; float değil, ondalık olarak ayrıştırın. Kaynak vermediyse null. |
| items[].released_at | string | null | Resmî yayım anı (UTC); bilinmiyorsa null. |
| items[].first_seen_at | string | null | Toplayıcımızın değeri ilk gördüğü an (UTC); backfill satırlarında null. |
| items[].revised_at | string | null | Satır bir revizyonsa dolu. |
| items[].vintage | string | live ya da backfill_latest (yukarıya bakın). |
| items[].series_break | string | null | Tanı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
