API belgesi
Sağlama API
17 Temmuz 2026 tarihliSayı SGL-v1-API
API, sitedeki kayıtlarla aynı veriyi sunar. Her cevap kaynağını, tarihini ve yöntem sürümünü taşır. Uçlar şu an sınırlı önizlemededir. Anahtarlar talep üzerine verilir.
Durum: açık önizleme. Okuma uçları önizleme süresince anahtarsız çalışır; anahtar ve hız sınırı üretim aşamasında gelir ve bu sayfada tarihiyle ilan edilir. Kurumsal deneme ve toplu veri için kurumsal sayfadaki adrese yazın.
Uçlar
- GET
/api/v1/hisse/{kod}Tek şirketin güncel kaydı: üç oran, eşikler, durum, beyan karşılaştırması, kaynak bildirimleri. - GET
/api/v1/hisse/{kod}/tarihceNokta zamanlı dönem kayıtları. Her satır o günkü bilgiyle saklanır, düzeltmeler ayrı satır olarak eklenir. - GET
/api/v1/listeEvren listesi: resmî endeks durumu ve Sağlama ölçümü, süzgeç parametreleriyle. - GET
/api/v1/sapmaResmî liste ile bağımsız hesabın farklı sonuç verdiği şirketler, dönem etiketiyle; kesin sapmalar ve kararı beyana bağlı kayıtlar ayrı listelenir.
Cevap şekli: JSON, UTF-8. Alan adları Türkçe ve dışa aktarım sözleşmesiyle aynıdır. Oran bloklarında value_pct ihtiyatlı üst sınırdır; lower_pct tablodan ve dipnotlardan ispatlanan alt sınır, certainty kesin veya beyana_bagli değerini alır. Durum sözlüğü: uygun, yakin, degil, beyana_bagli.
Örnek cevap
Alan adları ve yapı dışa aktarım sözleşmesinden gelir. Örnekteki değerler temsilîdir.
{
"ticker": "ORNMK",
"name": "Örnek Makina Sanayi ve Ticaret A.Ş.",
"official": { "in_katilim_tum": true, "indices": ["XKTUM", "XK100"],
"as_of": "2026-07-17", "source": "bist_csv" },
"olcum": {
"status": "uygun",
"period": "2025/12",
"computed_at": "2026-05-13",
"method_version": "tkbb_current@2025-08.v2",
"ratios": {
"borc": { "value_pct": 21.4, "threshold_pct": 33, "grace_pct": 36.3 },
"varlik": { "value_pct": 9.8, "threshold_pct": 33, "grace_pct": 36.3 },
"gelir": { "value_pct": 1.9, "lower_pct": 0.4, "upper_pct": 1.9,
"certainty": "kesin", "threshold_pct": 5, "grace_pct": 5.5 }
},
"sources": [
{ "label": "2025 yıllık finansal rapor (şirket İR)",
"url": "https://…", "sha256": "…", "date": "2026-03-06" }
]
},
"beyan": { "gelir_pct": 1.9, "varlik_pct": 9.8, "borc_pct": 21.4,
"period": "2025/12" }
}Hesap tarihi 13.05.2026 · yöntem tkbb_current@2025-08.v2
Anahtar ve sınırlar
Önizleme süresince okuma uçları anahtarsız ve herkese açıktır; cevaplar 5 dakika önbelleklenir ve başka sitelerden çağrılabilir. Üretim aşamasında anahtar ve anahtar başına hız sınırı gelir; sınırlar ve değişiklikler bu sayfada tarihiyle ilan edilir. Cevaplardaki veri sayfalardakiyle aynı kaynaktan gelir.