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.

Resmi KAP akışı üzerine kuruludur: her kayıt kaynak bildirimlerini disclosures[] (ya da disclosure_index) içinde listeler; bildirimin birebir halini /v1/kap-feed/disclosures/{index} ile açabilirsiniz.

Uç noktalar

Uç noktaKapsamAçıklama
GET/v1/buybacks?symbol=&status=&type=&from=&to=kapGeri alım programları: limitler, alınan pay, harcanan tutar, kapanış rakamları, kaynak bildirimler
GET/v1/buybacks/{program_key}kapTek 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=kapPiyasa genelinde geri alım işlemleri, her işlem bir kez
GET/v1/stocks/{id}/buybacks?include=trades&status=kapBir hissenin programları; include=trades her programın işlemlerini ekler
GET/v1/capital-actions?symbol=&kind=&stage=&form=&from=&to=kapSermaye artırımları (bedelsiz / bedelli / tahsisli), azaltımlar ve kayıtlı sermaye tavanı değişiklikleri
GET/v1/capital-actions/{action_key}kapTek bir sermaye işlemi, aşama zaman çizelgesiyle (bildirim başına bir kayıt)
GET/v1/stocks/{id}/capital-actions?kind=&stage=kapBir hissenin sermaye işlemleri
GET/v1/business-events?symbol=&kind=&counterparty_type=&from=&to=kapYeni 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-calendarkapBir şirketin finansal takvimi: geçmiş ve gelecek tüm dönemler

Deneme Alanı'nda deneyin →

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.

AlanTürNotlar
symbolstringTek 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).
symbolsstringVirgülle ayrılmış birden çok kod (en fazla 100). symbol ile birlikte kullanılamaz.
from / todate (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.
limitint 1–500Sayfa başına öğe, 1–500. Varsayılan 100.
cursorstringÖnceki sayfanın next_cursor değeri. Her imleçle aynı filtreleri gönderin; next_cursor null olunca durun.
orderdesc | ascdesc (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.

AlanTürNotlar
symbolstringHer 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_codestring | nullKAP'ın şirketi kaydettiği kod — VAKBN'ın finansal takvim bildirimlerinde TVB; genellikle symbol ile aynıdır.
tickersstring[]Ş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 — any ticker of İş Bankası finds the ISATR rows
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.

AlanTürNotlar
statusstringactive · 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).
typestringprogram (bir geri alım programı kapsamında) · other · serious_loss (SPK'nın ani ve ciddi kayıp yolu, program olmadan).
program_keystringKalıcı anahtar: <SYMBOL>-<KAP eventId>, ör. KARTN-65932. /v1/buybacks/{program_key} ve işlem filtresiyle kullanın.
curl — bir hissenin geri alım programları (scope: kap)
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/buybacks?symbol=KARTN"
response (excerpt)
{
  "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 — KARTN'ın ekimden bu yana geri alım işlemleri
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/buybacks/trades?symbol=KARTN&from=2026-10-01"
response (excerpt)
{
  "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 — per stock, with trades
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.

AlanTürNotlar
kindstringbonus · rights · private_placement · decrease · rights_other · authorized_capital (bunu içeren süreçlerle eşleşir).
stagestringannounced · spk_applied · spk_approved · rights_period · registered · withdrawn · cancelled.
formca | odaca (KAP'ın kurumsal işlem formu) ya da oda (eski form). Yalnızca liste rotasında filtre.
action_keystringKalı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 (scope: kap)
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/capital-actions?symbol=KRTEK"
response (excerpt)
{
  "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.

AlanTürNotlar
kindnew_business | tendernew_business ya da tender.
counterparty_typestringcustomer · 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 (scope: kap)
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/business-events?symbol=ASELS"
response (excerpt) — one amount, read by rule
{
  "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 — tenders
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/business-events?kind=tender"
response item (excerpt) — several amounts, read by a language model
{
  "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.

AlanTürNotlar
statusstringreported (dönemin finansal raporu KAP'ta: reported_at, report_index) · overdue (son tarih geçti, rapor yok) · planned · estimated.
indexstringBir BIST endeksinin üyeleri, ör. XU100.
sourcestringkap_calendar ya da estimated.
status (filter)stringplanned · 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 — BIST 100 companies reporting in the next 30 days (scope: kap)
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/earnings-calendar?index=XU100"
response item (excerpt)
{
  "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 — one company, every period
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-calendar

Hatalar, 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.