KAP kurumsal olaylar
Pay geri alımları, sermaye artırımları ve azaltımları, yeni iş ilişkileri ve ihaleler, finansal takvim — KAP bildirimlerinden ayrıştırılır, süreç başına tek kayda indirilir ve okunduğu her KAP bildirimine bağlanır.
Uç noktalar
| Uç nokta | Kapsam | Açıklama |
|---|---|---|
| GET/v1/buybacks?symbol=&status=&type=&from=&to= | kap | Geri alım programları: limitler, alınan pay, harcanan tutar, kapanış rakamları, kaynak bildirimler |
| GET/v1/buybacks/{program_key} | kap | Tek bir program; tüm işlemleri ve geri alınan payların satışlarıyla |
| GET/v1/buybacks/trades?symbol=&isin=&program_key=&from=&to= | kap | Piyasa genelinde geri alım işlemleri, her işlem bir kez |
| GET/v1/stocks/{id}/buybacks?include=trades&status= | kap | Bir hissenin programları; include=trades her programın işlemlerini ekler |
| GET/v1/capital-actions?symbol=&kind=&stage=&form=&from=&to= | kap | Sermaye artırımları (bedelsiz / bedelli / tahsisli), azaltımlar ve kayıtlı sermaye tavanı değişiklikleri |
| GET/v1/capital-actions/{action_key} | kap | Tek bir sermaye işlemi, aşama zaman çizelgesiyle (bildirim başına bir kayıt) |
| GET/v1/stocks/{id}/capital-actions?kind=&stage= | kap | Bir hissenin sermaye işlemleri |
| GET/v1/business-events?symbol=&kind=&counterparty_type=&from=&to= | kap | Yeni iş ilişkileri (sipariş, sözleşme) ve ihaleler, bildirim başına bir kayıt |
| GET/v1/earnings-calendar?symbol=&index=&source=&status=&from=&to= | kap | Şirketlerin finansal raporlarını ne zaman açıklayacağı: şirketin kendi tarihi ya da bir tahmin, yasal son tarihle |
| GET/v1/stocks/{id}/earnings-calendar | kap | Bir şirketin finansal takvimi: geçmiş ve gelecek tüm dönemler |
Kapsam ve ortak kurallar
Geçmiş 2024-10-04'ten başlar (daha önce başlayıp bildirim yapmaya devam eden geri alım programları dahil). Yeni KAP bildirimleri dakikalar içinde yansır. Dört ailenin hepsi aşağıdaki kuralları paylaşır.
| Alan | Tür | Notlar |
|---|---|---|
| symbol | string | Tek bir BIST kodu, bist: önekiyle ya da öneksiz (KARTN veya bist:KARTN). Bir şirketin herhangi bir kodu, KAP'ın başka bir kodla kaydettiği satırlar dahil o şirketin satırlarını bulur (VAKBN, TVB satırlarını; KRDMD, Kardemir'in KRDMA satırlarını bulur). |
| symbols | string | Virgülle ayrılmış birden çok kod (en fazla 100). symbol ile birlikte kullanılamaz. |
| from / to | date (YYYY-MM-DD) | Dahil Türkiye günleri, YYYY-MM-DD. Her uç nokta hangi güne göre filtrelediğini belirtir (aktivite günü, işlem günü, bildirim günü, yayım günü, açıklama günü). from, to'dan sonraysa 422. |
| limit | int 1–500 | Sayfa başına öğe, 1–500. Varsayılan 100. |
| cursor | string | Önceki sayfanın next_cursor değeri. Her imleçle aynı filtreleri gönderin; next_cursor null olunca durun. |
| order | desc | asc | desc (en yeni önce) ya da asc. Finansal takvimde varsayılan asc'dir (en yakın önce). |
Listeler {items, next_cursor, refreshed_at} biçiminde gelir; refreshed_at, API'nin veriyi en son yüklediği andır. Bilinmeyen bir sorgu parametresi, kabul edilenleri listeleyen bir 400'dür.
symbol, kap_code ve tickers
Her öğe şirketi üç şekilde adlandırır. Herhangi bir koduyla filtreleyin; görüntüleme ve PortGate'in geri kalanıyla eşleştirme için symbol'ü (bist:{symbol}) kullanın.
| Alan | Tür | Notlar |
|---|---|---|
| symbol | string | Her zaman BIST kodu (KAP'ın bildirim kodu TVB değil, VAKBN). Birden çok pay grubu olan şirketlerde KAP'ın bildirim yaptığı grup kalır (İş Bankası: ISATR). Borsada işlem görmeyen bir KAP üyesi KAP kodunu korur. |
| kap_code | string | null | KAP'ın şirketi kaydettiği kod — VAKBN'ın finansal takvim bildirimlerinde TVB; genellikle symbol ile aynıdır. |
| tickers | string[] | Şirketin tüm BIST kodları: ISATR → ["ISATR", "ISBTR", "ISCTR", "ISKUR"], KRDMA → ["KRDMA", "KRDMB", "KRDMD"]. Borsada işlem görmeyen KAP üyelerinde boş. |
| disclosures[] | object[] | Geri alımlar ve sermaye işlemleri: her kaynak bildirim; disclosure_index, link (kap.org.tr), published_at (UTC) ve reason (NEW · UPD · CORR · CANC) ile. Yeni iş / ihale ve finansal takvim satırları bunun yerine tek bir disclosure_index ve link taşır. |
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/capital-actions?symbol=ISCTR"
# → { "items": [ { "action_key": "ISATR-50108", "symbol": "ISATR", "kap_code": "ISATR",
# "tickers": ["ISATR", "ISBTR", "ISCTR", "ISKUR"], … } ], … }Pay geri alımları
KAP geri alım süreci (Payların Geri Alınmasına İlişkin Bildirim) başına bir öğe: KAP'taki limitler (max_shares, total_fund), şimdiye kadar alınan (shares_bought, amount_spent, avg_price — programın yayımlanmış işlemleri üzerinden toplanır) ve program bitince completion içinde KAP'ın kendi kapanış rakamları. Bunlar bildirildiği gibi gösterilir ve işlemlerin toplamından farklı olabilir.
Aktivite gününe göre sıralanır — son işlem ya da henüz alım yoksa yönetim kurulu kararı; from/to bu güne göre filtreler. from/to olmadan tüm programlar listelenir.
| Alan | Tür | Notlar |
|---|---|---|
| status | string | active · completed (kapanış rakamları bildirilmiş ya da KAP süreci tamamlandı olarak işaretlemiş) · terminated (erken sonlandırıldı) · cancelled (gerçekleştirilmedi ya da iptal edildi). |
| type | string | program (bir geri alım programı kapsamında) · other · serious_loss (SPK'nın ani ve ciddi kayıp yolu, program olmadan). |
| program_key | string | Kalıcı anahtar: <SYMBOL>-<KAP eventId>, ör. KARTN-65932. /v1/buybacks/{program_key} ve işlem filtresiyle kullanın. |
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/buybacks?symbol=KARTN"{
"items": [
{
"program_key": "KARTN-65932",
"symbol": "KARTN",
"kap_code": "KARTN",
"tickers": ["KARTN"],
"isin": "TRAKARTN91D4",
"share_group": "B",
"type": "program",
"status": "completed",
"board_decision_date": "2026-10-01",
"max_shares": 1000000.0,
"total_fund": 100000000.0,
"duration_months": 12,
"shares_bought": 1000000.0,
"amount_spent": 81681050.92,
"avg_price": 81.681051,
"trade_count": 15,
"first_trade_date": "2026-10-05",
"last_trade_date": "2026-10-30",
"completion": {
"total_shares": 1000000.0, "avg_price": 81.68, "max_price": 112.0,
"cost": 81681051.0, "period_start": "2026-10-01", "period_end": "2026-10-30",
"source": "İç Kaynaklar"
},
"event_id": 65932,
"disclosures": [
{
"disclosure_index": 1672660,
"link": "https://www.kap.org.tr/Bildirim/1672660",
"published_at": "2026-10-06T06:40:57Z",
"reason": "NEW"
},
…
],
…
}
],
"next_cursor": null,
"refreshed_at": "2026-11-02T09:54:15Z"
}İşlemler
/v1/buybacks/trades “bugün kim pay geri aldı” sorusunu yanıtlar. KAP bildirimleri önceki işlemleri yeniden listeler; her işlem bir kez, onu ilk listeleyen bildirimin programı altında listelenir (program_key, first_seen_index) ve published_at piyasanın işlemi ilk öğrendiği andır. Tarihi, fiyatı ya da pay adedi olmadan bildirilen satırlar dışarıda kalır. İşlem gününe göre sıralanır; from/to işlem gününe göre filtreler; isin ve program_key daha da daraltır.
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/buybacks/trades?symbol=KARTN&from=2026-10-01"{
"items": [
{
"symbol": "KARTN",
"kap_code": "KARTN",
"tickers": ["KARTN"],
"isin": "TRAKARTN91D4",
"share_group": "B",
"program_key": "KARTN-65932",
"trade_date": "2026-10-30",
"price": 82.67,
"shares": 40000.0,
"amount": 3306800.0,
"ratio_to_capital": 0.05333,
"cumulative_before": 960000.0,
"first_seen_index": 1690181,
"last_seen_index": 1690229,
"published_at": "2026-10-30T16:39:34Z"
},
…
],
"next_cursor": "…",
"refreshed_at": "…"
}Ayrıntı rotası ve include=trades ile hisse rotası trades ekler (en eski önce); ayrıntı ayrıca disposals listeler — geri alınan payların satışları, nominal, avg_price ve profit_loss ile.
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/stocks/bist:KARTN/buybacks?include=trades"Sermaye işlemleri
Sermaye artırımları (bedelsiz, bedelli, tahsisli), azaltımlar ve kayıtlı sermaye tavanı değişiklikleri — kaç bildirim sürerse sürsün KAP süreci başına bir öğe. kinds sürecin ne yaptığını listeler (bedelli ve bedelsiz artırım çoğu zaman tek süreçtir); tutarlar ve tarihler bildirilen en güncel değerlerdir.
stage ulaşılan en ileri adımdır: announced → spk_applied → spk_approved → rights_period → registered, ya da withdrawn / cancelled. En son bildirime göre sıralanır; from/to o bildirimin gününe göre filtreler. /v1/capital-actions/{action_key} timeline ekler: bildirim başına bir kayıt, işaret ettiği aşamayla.
| Alan | Tür | Notlar |
|---|---|---|
| kind | string | bonus · rights · private_placement · decrease · rights_other · authorized_capital (bunu içeren süreçlerle eşleşir). |
| stage | string | announced · spk_applied · spk_approved · rights_period · registered · withdrawn · cancelled. |
| form | ca | oda | ca (KAP'ın kurumsal işlem formu) ya da oda (eski form). Yalnızca liste rotasında filtre. |
| action_key | string | Kalıcı anahtar: <SYMBOL>-<KAP eventId> (eski form: <SYMBOL>-d<YK tarihi>-oda), ör. KRTEK-58193. |
Türe göre bloklar (sürecin parçası değilse null): bonus, rights (amount, rate_pct, price, kullanım dönemi), private_placement, decrease, ceiling (current / new / valid_until); ayrıca spk (başvuru / onay), record_date, payment_date, registration_date ve share_classes.
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/capital-actions?symbol=KRTEK"{
"items": [
{
"action_key": "KRTEK-58193",
"symbol": "KRTEK",
"kap_code": "KRTEK",
"tickers": ["KRTEK"],
"kinds": ["rights"],
"stage": "registered",
"form": "ca",
"board_decision_date": "2026-05-11",
"paid_in_capital": 35100498.42,
"target_capital": 137984613.049,
"currency": "TRY",
"bonus": null,
"rights": {
"amount": 105301495.26, "rate_pct": 300.0, "price": 1.0,
"exercise_start": "2026-08-03", "exercise_end": "2026-08-17",
"unused_amount": 2774213.631
},
"spk": { "application_date": "2025-07-17", "approval_date": "2026-07-29", "result": "Onay" },
"record_date": "2026-08-04",
"payment_date": "2026-08-05",
"registration_date": "2026-10-20",
"last_summary": "Sermaye Artırımının Tescili",
"last_published_at": "2026-10-20T13:01:47Z",
"disclosures": [
{ "disclosure_index": 1458022, "link": "https://www.kap.org.tr/Bildirim/1458022",
"published_at": "2025-07-07T15:20:04Z", "reason": "NEW" },
…
],
…
}
],
"next_cursor": "…",
"refreshed_at": "…"
}Yeni iş ilişkileri ve ihaleler
Yeni iş ilişkileri (sipariş, sözleşme) ve ihaleler (İhale Süreci / Sonucu), bildirim başına bir öğe. Spor kulüplerinin oyuncu sözleşmeleri bu kapsamda değildir. Yayım zamanına göre sıralanır; from/to yayım gününe göre filtreler.
| Alan | Tür | Notlar |
|---|---|---|
| kind | new_business | tender | new_business ya da tender. |
| counterparty_type | string | customer · supplier · other — yalnızca yeni iş ilişkisi. |
Tutar nasıl okunur
amount, işin currency cinsinden değeridir (birden çok para birimi var ve toplam yoksa MIXED). Bildirim tam olarak tek bir tutar içeriyorsa kuralla okunur (amount_method: "regex").
Bildirim birden çok tutar içeriyorsa — bir USD fiyat ve TL karşılığı, ilk ve nihai değer gibi — iş değerini bir dil modeli seçer (amount_method: "llm", amount_model ve amount_confidence ile) ve kod bu değeri bildirim metnine karşı doğrular. Doğrulamayı geçemeyen tutar yayımlanmaz: amount null kalır. Model adımı henüz çalışmadıysa amount_pending true, amount null'dır.
amount_try, bildirimin belirttiği TL değerdir (amount_try_source: "stated"); yoksa USD ya da EUR tutarın yayım günündeki TCMB döviz alış kuruyla karşılığıdır ("cbrt_buy"); diğer para birimlerinde yoktur. explanation bildirimin kendi metnini taşır; her rakamı kontrol edebilirsiniz.
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/business-events?symbol=ASELS"{
"items": [
{
"kind": "new_business",
"symbol": "ASELS",
"kap_code": "ASELS",
"tickers": ["ASELS"],
"disclosure_index": 1687338,
"published_at": "2026-10-26T11:35:51Z",
"link": "https://www.kap.org.tr/Bildirim/1687338",
"counterparty_type": "customer",
"counterparty_name": "Türkiye Cumhuriyeti Cumhurbaşkanlığı Savunma Sanayii Başkanlığı",
"share_of_sales_pct": 30.6,
"tender": null,
"amount": 523000000.0,
"currency": "EUR",
"amount_try": 29026343100.0,
"amount_try_source": "cbrt_buy",
"amount_method": "regex",
"amount_confidence": null,
"amount_model": null,
"amount_pending": false,
"explanation": "ASELSAN ile Türkiye Cumhuriyeti Cumhurbaşkanlığı Savunma Sanayii Başkanlığı arasında, …",
…
},
…
],
"next_cursor": "…",
"refreshed_at": "…"
}curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/business-events?kind=tender"{
"kind": "tender",
"symbol": "MEDTR",
"disclosure_index": 1688235,
"published_at": "2026-10-27T14:40:25Z",
"is_update": true,
"tender": {
"subject": "2027 Yılı Kemoterapi Malzemeleri",
"opened_by": "Dokuz Eylül Üniversitesi Rektörlüğü Uygulama ve Araştırma Hastanesi",
"bid_date": "2026-10-26",
"result_text": "İhale Komisyon kararı hükümleri dahilinde uhdemizde kalmıştır.",
"value": 48804230.0,
"value_currency": "TRY",
"value_raw": "48.804.230,00 TL",
…
},
"amount": 48315170.0,
"currency": "TRY",
"amount_try": 48315170.0,
"amount_try_source": "stated",
"amount_method": "llm",
"amount_confidence": "high",
"amount_model": "…",
"amount_pending": false,
…
}Finansal takvim
Şirket ve dönem başına bir satır. Şirket kendi KAP Finansal Takvim bildirimini yaptıysa source: "kap_calendar" (planned_date, planned_timing, planned_note); yapmadıysa source: "estimated" — estimated_date, şirketin aynı dönemi bir yıl önce yayımladığı tarihtir; bu yılın bir sonraki iş gününe kaydırılır ve son tarihle sınırlanır.
deadline, SPK II-14.1 tebliğine göre yasal son tarihtir (konsolide rakamlar: 1. ve 3. çeyrekten 40 gün, 2. çeyrekten 50 gün, yıl sonundan 70 gün sonra); hafta sonuna ya da BIST tatiline denk gelirse bir sonraki iş gününe kayar.
| Alan | Tür | Notlar |
|---|---|---|
| status | string | reported (dönemin finansal raporu KAP'ta: reported_at, report_index) · overdue (son tarih geçti, rapor yok) · planned · estimated. |
| index | string | Bir BIST endeksinin üyeleri, ör. XU100. |
| source | string | kap_calendar ya da estimated. |
| status (filter) | string | planned · estimated · reported · overdue. |
Varsayılan pencere
from/to açıklama gününe göre filtreler (planned_date, yoksa estimated_date). from/to olmadan:
- symbol/symbols yoksa: bugün … bugün + 30 gün (Türkiye) — gelecek ayın takvimi. Tek başına index= bu pencereyi korur.
- symbol ya da symbols varsa: pencere yok — o şirketlerin geçmiş ve gelecek tüm dönemleri.
- yalnızca from: symbol/symbols yoksa from … from + 30 gün, varsa ucu açık.
curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/earnings-calendar?index=XU100"{
"symbol": "CCOLA",
"kap_code": "CCOLA",
"tickers": ["CCOLA"],
"period_label": "Q3",
"period_start": "2026-07-01",
"period_end": "2026-09-30",
"planned_date": "2026-11-03",
"planned_timing": "after_close",
"planned_note": "Şirketimizin 1 Ocak 2026 - 30 Eylül 2026 dönemine ilişkin finansal ve operasyonel sonuçlarının 3 Kasım 2026 tarihinde Borsa İstanbul seans kapanışı sonrasında kamuya açıklanması planlanmaktadır.",
"estimated_date": "2026-11-04",
"deadline": "2026-11-09",
"source": "kap_calendar",
"status": "planned",
"reported_at": null,
"report_index": null,
"disclosure_index": 1683575,
"link": "https://www.kap.org.tr/Bildirim/1683575",
"published_at": "2026-10-19T10:26:02Z"
}curl -H "X-API-Key: $PORTGATE_KEY" \
"https://api.theportfoy.com/portgate/v1/earnings-calendar?symbol=TCELL"
# same rows as /v1/stocks/bist:TCELL/earnings-calendarHatalar, kapsam ve ölçüm
Bilinmeyen sorgu parametresi, geçersiz sembol (ör. bir us: kimliği), symbol ile symbols birlikte ya da hatalı imleç için 400; bilinmeyen program_key / action_key ya da /v1/stocks/{id}/… rotalarında bist: olmayan kimlik için 404; hatalı tarih, from'un to'dan sonra olması ya da {id} yerine öneksiz kod için 422 (bist:KARTN kullanın). Olayı olmayan bir kod hata değil, boş listedir. Yeniden başlatmanın ardından veri yüklenirken uç noktalar Retry-After başlığıyla 503 döner — o kadar saniye bekleyip yeniden deneyin.
On uç noktanın hepsi kap kapsamı ister — resmi KAP akışıyla aynı kapsam. Dönen her başlayan 100 öğe için 1 birim ölçülür (istek başına en az 1). Ayrıca bakınız: Hatalar ve hız limitleri.
