İçeriğe geçin
SAĞLAMAKATILIM FİNANS ANALİZİ

API BELGESİ

Sağlama API — belge referanslı uçlar

API

17 TEMMUZ 2026 TARİHLİ · SAYI: SGL-v1-API

API'nin sözleşmesi ürünle aynıdır: her cevap kaynağını, tarihini ve yöntem sürümünü taşır. Uçlar şu an sınırlı önizlemededir; anahtarlar elle verilir.

Durum: sınırlı önizleme. Deneme anahtarı için kurumsal sayfadaki adrese yazın; otomatik kayıt açılınca bu sayfada tarihiyle ilan edilir.

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, düzeltmeler ayrı satır.
  • GET /api/v1/listeEvren listesi: resmî endeks durumu + bizim ölçüm, süzgeç parametreleriyle.
  • GET /api/v1/sapmaResmî liste ile bağımsız hesabın ayrıştığı şirketler, dönem etiketiyle.

ÖRNEK CEVAP

Alan adları ve şekil dondurulmuş 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": "v0.1",
    "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, "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" }
}

Sağlaması yapıldı — 13.05.2026 · yöntem v0.1

ANAHTAR VE SINIRLAR

Anahtarlar elle verilir (önizleme). Hız sınırı anahtar başına tanımlanır; sınırlar ve değişiklikler bu sayfada tarihiyle ilan edilir. Cevaplardaki veri, sayfalardakiyle aynı kaynaktan gelir — API ayrı bir gerçek üretmez.

Sağlama

«Sağlamasını yapmak»: bir hesabı, sonucuna güvenmek için yeniden hesaplamak. Adımız, işimizin tarifidir.

TKBB, AAOIFI, Borsa İstanbul ve KAP; ilgili kurumların adları ve markalarıdır. Sağlama bu kurumlarla bağlı ya da bağlantılı değildir; standartlarına yalnızca kamuya açık metinleri üzerinden, kaynak göstererek atıf yapar. © 2026 Sağlama (çalışma adı — şirketleşme sürecinde).