Fintables

Bir veya birden fazla chunk'ın tam içeriğini döndürür. **Dikkat**: Bu araç yalnızca chunk `id`'leri kabul eder — `dokuman_id` ile çağrılamaz. Chunk `id`'lerini `dokumanlarda_ara` sonuçlarından al.

Doküman havuzunda full-text arama yapar. Dönen sonuçlar dokümanların chunk'larıdır; her chunk bir belgenin bir sayfasını temsil eder. **Önemli**: `id` (chunk kimliği) ile `dokuman_id` (doküman kimliği) farklı şeylerdir. Her doküman birden fazla chunk'tan oluşur. `dokuman_chunk_yukle` aracı yalnızca chunk `id`'leri kabul eder — doküman ID'si ile çağrılamaz. Bir dokümanın tüm içeriğini okumak için: `dokumanlarda_ara(query="", filter='dokuman_id = "ABC123"')` ile chunk'larını bul, sonra dönen `id`'leri `dokuman_chunk_yukle`'ye ver. **Not**: Bunu grep/ripgrep alternatifi olarak düşünüp öyle aramalar yap. Semantik arama değil. Dönen yapı: - `toplam`: Filtreye uyan gerçek toplam sonuç sayısı. - `sayfa`: Dönen sayfa numarası. - `sayfa_basi`: Sayfa başına kayıt sayısı. - `toplam_sayfa`: Toplam sayfa sayısı. - `sonuclar`: Kayıt listesi. Kayıt şeması: - Ortak alanlar: `id` (chunk kimliği — `dokuman_chunk_yukle` ile tam içeriği yüklemek için bu değeri kullanın), `highlight`, `dokuman_id`, `sayfa_no`, `dokuman_tipi`, `yayinlanma_tarihi_utc`, `iliskili_semboller` - `kap_haberi` / `kap_haber_eki`: `kap_bildirim_id`, `kap_bildirim_tipi`, `kap_bildirim_konu` - `faaliyet_raporu` / `finansal_rapor`: `yil`, `ay` - `finansal_rapor`: Finansal tablolarda yer alan rakamların arkasındaki detayları açıklayan; borçların yapısı, varlıkların içeriği, gelir ve gider kalemlerinin nasıl oluştuğu gibi bilgileri gösteren açıklama bölümüdür. - `faaliyet_raporu`: Şirket yönetiminin yıl veya dönem boyunca şirketin operasyonel performansını, stratejisini, yatırımlarını, risklerini ve gelecek beklentilerini yatırımcılara anlattığı kapsamlı bilgilendirme raporudur. - `araci_kurum_raporu`: Aracı kurumların bir şirketi veya sektörü analiz ederek finansal performansını, değerlemesini ve gelecek beklentilerini değerlendirdiği; genellikle hedef fiyat ve yatırım tavsiyesi (AL, TUT, SAT) içeren araştırma raporudur. - `kurumsal_bilgi_karti`: `tip` (hisse/fon) - `fintables_arastirma_yazisi`: `yazar`, `kategori` <example> GARAN 2025/12 faaliyet raporlarında arama yapmak için: query: kapasite kullanım oranı Gölcük Yeniköy Eskişehir Craiova filter: dokuman_tipi = "faaliyet_raporu" AND yil = 2025 AND ay = 12 AND iliskili_semboller = "GARAN" </example>

Çeşitli analizlerin nasıl ve hangi tablolarda yapılabileceğinin detaylarını döndürür. Verilen skill isimlerini yükler ve her skill için şema çıktısı döndürür. Not: Aynı skill'i bir kez yüklemek yeterlidir. Aynı skill'i tekrar yüklemenin hiçbir etkisi yoktur.

Typo-tolerant sembol ve aracı kurum arama. Hisse, fon ve diğer sembol tiplerini tek istekte arar. Kod/ünvan kullanırken yalnızca bu aracın döndürdüğü eşleşmeleri kullan.

Borsa İstanbul verilerine readonly SQL erişimi sağlar. <rules> - Sadece tek ifadeli okuma amaçlı sorgu yaz (SELECT veya WITH ... SELECT). - Tablo/kolon ayrıntıları için önce ilgili skill'i `finansal_beceri_yukle([skill_adı])` ile yükle, sonra o şemaya göre sorgu yaz. - Burada temel veri setleriyle ilgili bilgiler var, her yüklenen "finansal beceri" daha çok tabloyu açığa çıkarabilir. - Gömülü tablolardan değilse ve bir skill yüklenmeden, yani sana açıkça verilmeden tablo/kolon adları veya şema hakkında tahminde bulunma. - Birden fazla ifade, `SET`, `SHOW`, `EXPLAIN`, DDL/DML, temp tablo ve benzeri PostgreSQL komutları desteklenmez. - Sadece temel filtreleme, join, grouping, ordering, DISTINCT, DISTINCT ON, `UNION` / `UNION ALL`, `= ANY(array_kolon)`, `array_kolon @> ARRAY[...]`, `array_kolon <@ ARRAY[...]`, `array_kolon && ARRAY[...]` gibi array ifadeleri, `payload @> '...'::jsonb`, `payload ? 'x'`, `payload ?| ARRAY[...]`, `payload ?& ARRAY[...]` gibi JSONB containment/existence operatörleri, `NULLIF(...)`, `COALESCE(...)`, `CASE WHEN ... THEN ... END`, `ROUND(...)`, `CEIL(...)`, `FLOOR(...)`, `EXTRACT(YEAR FROM zaman_kolonu)`, `INTERVAL '1 day'`, `UNNEST(array_kolon)`, `COUNT(DISTINCT kolon)` gibi aggregate DISTINCT kullanımları, `ROW_NUMBER() OVER (...)`, `PERCENT_RANK() OVER (...)`, `SUM(...) OVER (...)` gibi izinli aggregate window fonksiyonları, FROM/JOIN içinde alias'lı alt sorgular ve `(a, b) IN (SELECT ...)`, `(a, b) = (SELECT x, y ...)` gibi row-value karşılaştırmaları ile izinli yerleşik fonksiyonları kullan. - Performans için tarih/saat filtrelerini literal değerle ver. CURRENT_DATE kullanma. - Zaman kolonlarında timezone ipucu kolon isimlerinde bulunur: - tarih kolonları `*_europe_istanbul` adını taşır ve Europe/Istanbul takvim gününü temsil eder. - barbar kaynaklı timestamp kolonları `zaman_utc` adını taşır ve UTC'dir. Günlük değer bile olsa UTC isminde `utc` geçerse UTC olarak konrol et. - Kullanıcı saat verdiğinde önce Türkiye saati (Europe/Istanbul) olarak yorumla, sonra SQL'de UTC literal ile filtrele. - Örneğin: Veritabından bir _utc kolonundan `2025-03-01 21:00` gelir ama sen kullanıya 2 Mart 2025 dersin çünkü kullanıcı Türkiye'de. </rules> Gömülü temel tablo rehberi: - `hisse_senetleri`: Borsa İstanbul'da işlem gören hisse senetleri. - `hisse_senedi_kodu` (character varying(10)): Borsa kodu (ticker). - `unvan` (character varying(255)): Şirketin tam unvanı. - `aciklama` (text): Şirketin kısa açıklaması. - `fiili_dolasim_orani` (numeric(5,2)): Fiili dolaşımdaki pay oranı (%). - `logo` (character varying(100)): Şirket logo URL adresi. - `sektor_id` (integer): Sektör kimliği (sektorler.id ile eşleşir). - `fonksiyonel_para_birimi` (character varying(3)): Fonksiyonel para birimi (TRY, USD vb.). - `son_fiyat` (double precision): Güncel son işlem fiyatı (TRY). Geçmiş fiyat verisi için ohlcv becerisini kullanın. - `son_fiyat_zaman_utc` (timestamp with time zone): Son fiyatın oluştuğu zaman (UTC). - `gunici_getiri` (numeric): Gün içi getiri (%). - `endeksler` (character varying[]): Dahil olduğu endeks kodları listesi. - `odenmis_sermaye` (numeric): Ödenmiş sermaye (pay adedi). - `fiili_dolasim_pay_adedi` (numeric): Fiili dolaşımdaki pay adedi. - `piyasa_degeri` (numeric): Piyasa değeri (TRY). Hesaplama: ödenmiş sermaye × son fiyat. - `sektorler`: BIST sektör tanımları (hisse_senetleri.sektor_id ile eşleşir). - `id` (integer): Sektör kimliği. - `baslik` (character varying(255)): Sektör adı. - `aciklama` (text): Sektör açıklaması. - `endeksler`: Borsa İstanbul endeksleri ve anlık fiyat/getiri alanları (XU030, XU050, XU100 vb.). - `endeks_kodu` (character varying(10)): Endeks kodu, örnek: XU030, XU050, XU100. - `baslik` (character varying(255)): Endeksin tam adı. - `son_fiyat` (double precision): Güncel son işlem fiyatı (puan). Geçmiş fiyat verisi için ohlcv becerisini kullanın. - `son_fiyat_zaman_utc` (timestamp with time zone): Son fiyatın oluştuğu zaman (UTC). - `gunici_getiri` (numeric): Gün içi getiri (yüzde, bir önceki kapanışa göre). - `hisse_senedi_tarihsel_carpanlar`: Hisse senetlerinin tarihsel çarpan değerleri. - `hisse_senedi_kodu` (text): Borsa kodu (hisse_senetleri.hisse_senedi_kodu ile eşleşir). - `tarih_europe_istanbul` (string): Europe/Istanbul takvim gününü temsil eden tarih kolonu (date). - `fk` (numeric): Fiyat/Kazanç oranı. - `pddd` (numeric): Piyasa Değeri / Defter Değeri. - `fd_favok` (numeric): Firma Değeri / FAVÖK. - `fd_s` (numeric): Firma Değeri / Satış. - `roic` (numeric): Yatırılan Sermayenin Getirisi (Return on Invested Capital). - `hisse_senedi_temettuler`: Hisse senetlerinin temettü dağıtım geçmişi. - `hisse_senedi_kodu` (character varying(10)): Borsa kodu (hisse_senetleri.hisse_senedi_kodu ile eşleşir). - `tarih_europe_istanbul` (date): Europe/Istanbul takvim gününü temsil eden tarih kolonu (date). - `temettu_verimi` (double precision): Temettü verimi (%). - `nakit_temettu` (bigint): Nakit temettü tutarı. - `brut_hisse_basi_temettu` (double precision): Brüt hisse başı temettü. - `net_hisse_basi_temettu` (double precision): Net hisse başı temettü. - `dagitim_orani` (integer): Dağıtım oranı (%). - `odendi` (boolean): Ödendi mi? (boolean). - `hisse_senedi_sermaye_artirimlari`: Hisse senetlerinin sermaye artırımı geçmişi. - `hisse_senedi_kodu` (character varying(10)): Borsa kodu (hisse_senetleri.hisse_senedi_kodu ile eşleşir). - `tarih_europe_istanbul` (date): Europe/Istanbul takvim gününü temsil eden tarih kolonu (date). - `arttirim_sonrasi_sermaye` (bigint): Artırım sonrası sermaye. - `ihrac_orani` (double precision): İhraç oranı. - `bedelsiz_oran` (double precision): Bedelsiz sermaye artırımı oranı. - `ic_kaynaklardan_bedelsiz_oran` (double precision): İç kaynaklardan bedelsiz oran. - `diger` (double precision): Diğer açıklamalar. - `dagitildi` (boolean): Dağıtım gerçekleşti mi? (boolean). - `onaylandi` (boolean): Onaylandı mı? (boolean). - `ruchan_baslangic_europe_istanbul` (date): Europe/Istanbul takvim gününü temsil eden tarih kolonu (date). - `ruchan_bitis_europe_istanbul` (date): Europe/Istanbul takvim gününü temsil eden tarih kolonu (date). - `hisse_finansal_tablolari`: Finansal tablo dönemleri (bilanço, gelir tablosu, nakit akış). Her satır bir şirketin bir finansal dönemidir. - `hisse_senedi_kodu` (text): Borsa kodu (hisse_senetleri.hisse_senedi_kodu ile eşleşir). - `yil` (smallint): Finansal dönem yılı. - `ay` (smallint): Finansal dönem ayı (3, 6, 9 veya 12). - `yayinlanma_tarihi_utc` (timestamp with time zone): Finansal tablonun KAP'ta yayınlandığı tarih. - `finansal_rapor_kap_bildirim_id` (bigint): Finansal raporun yayınlandığı KAP bildirim numarası. - `faaliyet_raporu_kap_bildirim_id` (bigint): Faaliyet raporunun yayınlandığı KAP bildirim numarası. - `finansal_tablo_sablonu` (text): Şirketin kullandığı finansal tablo şablonu (default, bank, factoring, insurance, leasing, asset_management, doco). - `hisse_finansal_tablolari_bilanco_kalemleri`: Bilanço kalemleri. Her satır bir dönem için bir bilanço kalemidir (örn: Nakit ve Nakit Benzerleri). - `hisse_senedi_kodu` (text): Borsa kodu (hisse_senetleri.hisse_senedi_kodu ile eşleşir). - `yil` (smallint): Finansal dönem yılı. - `ay` (smallint): Finansal dönem ayı (3, 6, 9 veya 12). - `satir_no` (smallint): Kalemin bilanço içindeki sırası. - `kalem` (text): Bilanço kalem adı (kalem isimleri `finansal_tablolar` becerisi ile gelir). - `try_donemsel` (bigint): Dönemsel TRY değer. - `usd_donemsel` (bigint): Dönemsel USD değer. - `eur_donemsel` (bigint): Dönemsel EUR değer. - `hisse_finansal_tablolari_gelir_tablosu_kalemleri`: Gelir tablosu kalemleri. Her satır bir dönem için bir gelir tablosu kalemidir (örn: Satışlar). - `hisse_senedi_kodu` (text): Borsa kodu (hisse_senetleri.hisse_senedi_kodu ile eşleşir). - `yil` (smallint): Finansal dönem yılı. - `ay` (smallint): Finansal dönem ayı (3, 6, 9 veya 12). - `satir_no` (smallint): Kalemin gelir tablosu içindeki sırası. - `kalem` (text): Gelir tablosu kalem adı (kalem isimleri `finansal_tablolar` becerisi ile gelir). - `try_donemsel` (bigint): Dönemsel TRY değer. - `usd_donemsel` (bigint): Dönemsel USD değer. - `eur_donemsel` (bigint): Dönemsel EUR değer. - `try_ceyreklik` (bigint): Çeyreklik TRY değer. - `usd_ceyreklik` (bigint): Çeyreklik USD değer. - `eur_ceyreklik` (bigint): Çeyreklik EUR değer. - `try_ttm` (bigint): Yıllıklandırılmış (TTM) TRY değer. - `usd_ttm` (bigint): Yıllıklandırılmış (TTM) USD değer. - `eur_ttm` (bigint): Yıllıklandırılmış (TTM) EUR değer. - `hisse_finansal_tablolari_nakit_akis_tablosu_kalemleri`: Nakit akış tablosu kalemleri. Her satır bir dönem için bir nakit akış kalemidir. - `hisse_senedi_kodu` (text): Borsa kodu (hisse_senetleri.hisse_senedi_kodu ile eşleşir). - `yil` (smallint): Finansal dönem yılı. - `ay` (smallint): Finansal dönem ayı (3, 6, 9 veya 12). - `satir_no` (smallint): Kalemin nakit akış tablosu içindeki sırası. - `kalem` (text): Nakit akış kalem adı (kalem isimleri `finansal_tablolar` becerisi ile gelir). - `try_donemsel` (bigint): Dönemsel TRY değer. - `usd_donemsel` (bigint): Dönemsel USD değer. - `eur_donemsel` (bigint): Dönemsel EUR değer. - `try_ceyreklik` (bigint): Çeyreklik TRY değer. - `usd_ceyreklik` (bigint): Çeyreklik USD değer. - `eur_ceyreklik` (bigint): Çeyreklik EUR değer. - `try_ttm` (bigint): Yıllıklandırılmış (TTM) TRY değer. - `usd_ttm` (bigint): Yıllıklandırılmış (TTM) USD değer. - `eur_ttm` (bigint): Yıllıklandırılmış (TTM) EUR değer. - `hisse_finansal_tablolari_finansal_oranlari`: Finansal oranlar (likidite, karlılık, borç vb). Her satır bir dönem için bir finansal orandır. - `hisse_senedi_kodu` (text): Borsa kodu (hisse_senetleri.hisse_senedi_kodu ile eşleşir). - `yil` (smallint): Finansal dönem yılı. - `ay` (smallint): Finansal dönem ayı (3, 6, 9 veya 12). - `satir_no` (smallint): Oranın kategori içindeki sırası. - `kategori` (text): Oran kategorisi (oran kategorileri `finansal_tablolar` becerisi ile gelir). - `oran` (text): Oran adı (oran isimleri `finansal_tablolar` becerisi ile gelir). - `deger` (numeric): Oran değeri.