Ekonomik takvim
Küresel makro-olay takvimi — enflasyon verileri, merkez bankası faiz kararları, PMI'lar, istihdam raporları ve dahası, 74 ülke genelinde — her olay piyasa beklentisi, önceki değeri ve açıklandığında gerçekleşen değeriyle. Tek kapsam, her planda dahil.
Uç noktalar
| Uç nokta | Kapsam | Açıklama |
|---|---|---|
| GET/v1/calendar | calendar:read | Bir penceredeki tarihli olaylar; actual / forecast / previous ile |
| GET/v1/calendar/events | calendar:read | Olay tanımları (referans verisi; tarih ve değer içermez) |
| GET/v1/calendar/events/{event_id} | calendar:read | Kimliğe göre tek bir olay tanımı |
Sorgu parametreleri
| Alan | Tür | Notlar |
|---|---|---|
| from / to | date | Pencere başlangıcı, dahil — bir TRT takvim günü. Varsayılan: bugün (TRT). Pencere sonu, dahil. Varsayılan: from + 7 gün. Pencere 31 günle sınırlıdır (daha genişi → 400); from'dan önceki bir to da 400 döner. Olayı olmayan bir pencere hata değil, boş bir 200'dür. |
| country | string, repeatable | ISO-2 ülke kodu, tekrarlanabilir: country=tr&country=us. Büyük/küçük harf duyarsız — aşağıdaki nota bakın. |
| importance | int 1–3 | Asgari önem; akışta da katalogda da: 2, “2 ve 3” demektir. 1 düşük · 2 orta · 3 yüksek. |
| event_id | int | Akışı tekrarlayan tek bir olaya filtreler (ör. her TÜFE verisi). |
actual, açıklanana kadar null'dır
Bir olayın açıklanma anından önce actual null'dır; forecast ve previous ise çoktan doludur — buradaki null “veri yok” değil, “henüz açıklanmadı” demektir. Rakam yayımlandığında actual genellikle dakikalar içinde dolar.
forecast ve previous açıklanma anına kadar revize edilebilir; açıklanmış bir actual da sonradan revize edilebilir. Biz en güncel değeri sunarız — revizyon geçmişi tutulmaz. Her olayın beklentisi de yoktur: az takip edilen veriler çoğu zaman forecast: null ve yalnızca bir previous ile gelir.
is_speaking: true — Fed başkanı konuşmaları, FOMC tutanakları ve benzeri) sayısal bir sonucu yoktur: actual, forecast, previous ve unit doğaları gereği boş kalır.Saatler UTC'dir — TSİ +3'tür
time, ISO-8601 UTC bir andır. Türkiye saati (TSİ) yıl boyunca UTC+3'tür (yaz saati yoktur); yani 07:00Z bir TÜFE verisi 10:00 TSİ demektir. Dönüşümü kendi tarafınızda yapın; biz asla yerel saat sunmayız.
Pencere sınırları bunun istisnasıdır: from/to (ve yanıttaki from_date/to_date) TRT takvim günleridir — bir günün olayları Türkiye takvim gününe göre gruplanır; açıklama takvimleri de böyle yayımlanır. Kayıtlar kronolojiktir (önce time, sonra event_id).
Olay ve ülke adları yalnızca Türkçedir
Olay alanları
| Alan | Tür | Notlar |
|---|---|---|
| event_id | int | Tekrarlayan olayın kalıcı kimliği — aynı TÜFE verisi her ay aynı kimliği taşır |
| name | string | Olay adı, Türkçe (yukarıdaki dil notuna bakın) |
| country.name / country.code | string | Türkçe ülke adı + büyük harf ISO-2 kodu |
| currency | string | Olayın ekonomisinin para birimi (TRY, USD, …) |
| importance | int 1–3 | 1 düşük · 2 orta · 3 yüksek — üst kaynağın puanı; bizim ağırlıklandırmamız değil |
| is_speaking | bool | Konuşma/tutanak için true — değer alanları boş kalır |
| actual | number | null | Gerçekleşen değer — açıklanma anına kadar null (yukarıya bakın) |
| forecast | number | null | Piyasa beklentisi — beklenti takip edilmiyorsa null |
| previous | number | null | Önceki dönemin değeri |
| unit | string | null | Birim eki: %, B (milyar) ya da endeks türü sayılar için null/boş |
| time | datetime (UTC) | Planlanan açıklanma anı, UTC ISO-8601 (TSİ = +3) |
Örnek — bir hafta, filtreli
Bir haftadaki orta ve üzeri önemde TR ve ABD olayları. Her ülke için country parametresini tekrarlayın:
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/calendar?from=2026-08-24&to=2026-08-30&country=tr&country=us&importance=2"{
"from_date": "2026-08-24",
"to_date": "2026-08-30",
"items": [
{
"event_id": 653,
"name": "Perakende Satışlar (Yıllık) (Tem)",
"country": { "name": "Polonya", "code": "PL" },
"currency": "PLN",
"importance": 2,
"is_speaking": false,
"actual": null,
"forecast": 4.5,
"previous": 6.8,
"unit": "%",
"time": "2026-08-24T10:30:00Z"
}
],
"count": 1
}Yalnızca actual değişti — satır kimliğini, saatini ve penceresini korur. (Temsili değer; yukarıdaki örnek gerçek bir açıklanma-öncesi kaynak satırıdır.)
{
"event_id": 653,
"name": "Perakende Satışlar (Yıllık) (Tem)",
"country": { "name": "Polonya", "code": "PL" },
"currency": "PLN",
"importance": 2,
"is_speaking": false,
"actual": 4.8,
"forecast": 4.5,
"previous": 6.8,
"unit": "%",
"time": "2026-08-24T10:30:00Z"
}Olay kataloğu
Katalog, takip ettiğimiz tüm olay tanımlarını listeler — 74 ülkede yaklaşık 1.800 olay — {items, count} biçiminde, event_id sırasıyla, tarih ve değer olmadan. Bir event_id değerini bir kez ada çözmek ya da akışı filtrelemek için kimlik keşfetmek amacıyla kullanın. country (burada tek değer; tekrarlanamaz) ve aynı asgari-importance filtresini kabul eder.
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/calendar/events?country=tr"curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/calendar/events/871"{
"event_id": 871,
"name": "TÜFE (Yıllık)",
"country": { "name": "Türkiye", "code": "TR" },
"currency": "TRY",
"importance": 2,
"is_speaking": false
}Kapsam ve planlar
Tüm takvim uç noktaları calendar:read kapsamıyla korunur ve bu kapsam ücretsiz ya da ücretli tüm planlara dahildir. Anahtarınız bu kapsamdan eskiyse, geliştirici portalında anahtarı yeniden oluşturun (ya da kapsamı ekleyin); takvim açılır.
Ayrıca bakınız: /docs/authentication · veri ve tazelik politikası