Haberler

BIST ve ABD hisseleri için zenginleştirilmiş piyasa haberleri — başlıklar lisanslı haber akışları ve KAP (TR) ile lisanslı bir ABD haber akışından gelir; her biri yapay zeka tarafından yazılan bir özet ve duyarlılık taşır ve bahsettiği enstrümanlarla etiketlenir.

Yapay zeka üretimi alanlar — önce bunu okuyun

Olgusal alanlar (başlık, bağlantı, yayıncı, semboller, yayın zamanı) kaydın alındığı halidir. Özet ve duyarlılık bir yapay zeka modeli tarafından üretilir ve hata içerebilir — yatırım tavsiyesi değildir. Her yanıt bu kaynağı taşır: akış/haber nesneleri bunu ai altında iç içe verir, sembol bazlı kartlar ise bir ai_disclaimer içerir.

Uç noktalar

Uç nokta	Kapsam	Açıklama
GET/v1/news?market=bist\|us	news:{market}	Piyasa akışı, en yeni önce (imleçle sayfalanır)
GET/v1/news/{news_id}	news:{market}	Kimliğe göre tek bir haber
GET/v1/stocks/{id}/news	news:{market}	Tek bir enstrüman için son haberler (yapay zeka 'neden' kartıyla)

Deneme Alanı'nda deneyin →

Özetler Türkçedir

Yapay zeka özeti ve duyarlılık gerekçesi, ABD haberleri için bile Türkçe yazılır (boru hattı Türkiye önceliklidir). ai.language bunu belirtir. Olgusal alanlar kaynak dilinde kalır.

Piyasa akışı

Bir piyasa seçin (bist veya us) — bu aynı zamanda kapsam kapısıdır. Akış en yeniden eskiye sıralanır ve opak bir imleçle sayfalanır: aldığınız next_cursor değerini bir sonraki sayfa için ?cursor= olarak geçin. ?category= ile bir kategoriye filtreleyin.

curl — latest US news, one page

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/news?market=us&limit=20"

TR kategorileri: E (ekonomi/makro), F (şirket/finansal), KAP (kurumsal açıklamalar), Y, X. ABD haberleri tek bir US_Market kategorisini kullanır. Kategori piyasayla eşleşmezse 400 alırsınız.

Tek bir hisse için haberler

Sembol bazlı haberler, hisse sayfaları için tasarlanmış hafif bir karttır — boru hattının ürettiği yerlerde tek cümlelik bir yapay zeka gerekçesi ("neden hareket etti") ve bir duyarlılık etiketi içerir. ABD kimlikleri us: ad alanını kullanır (us:AAPL); BIST ise bist:THYAO'dur.

curl — latest news for a stock

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/stocks/bist:THYAO/news?limit=10"

Akış öğesi alanları

Alan	Tür	Notlar
published_at	datetime	Yayın zamanı, UTC'ye normalize edilir (TR kaynakları yerel saati saklar; biz dönüştürürüz)
symbols	string[]	Bahsedilen enstrümanlar, PortGate kimlikleri olarak (ör. bist:THYAO, us:AAPL)
keywords	string[]	Konu anahtar kelimeleri
ai	object	Yapay zeka zarfı: summary, sentiment {score 0–10, reasoning}, generated_by, language, disclaimer
publisher / author / image_url	string?	Yalnızca ABD: publisher, author, image_url

Saatlerin neden UTC olduğu ve her akışın gecikmesinin nasıl işlediği: Veri ve tazelik politikası.