[ blog · comparison ]9 min read

Şirket Temelleri API'si: Finans Ajanları için Bilanço, Nakit Akışı ve İçeriden Alım Satımlar

Sarah ChoyYayımlanma tarihi: 16 Haziran 20269 dk okuma

Fiyatlar piyasanın ne düşündüğünü söyler; temeller ise piyasanın haklı olup olmadığını söyler. İşte yapay zeka ajanları için biçimlendirilmiş bir temeller API'si — tablolar, temettüler ve içeriden işlemler tek bir endpoint'te — ve ham SEC EDGAR ile tablo-API sağlayıcılarına kıyasla durumu.

Özet

•Temeller = 'iş gerçekten sağlıklı mı?' katmanı: bilanço, gelir tablosu, nakit akışı, temettüler, içeriden işlemler.
•Bunu SEC EDGAR'dan (XBRL) ücretsiz ayrıştırabilirsiniz, ancak XBRL'i farklı bildirim sahipleri ve dönemler arasında normalleştirmek gerçek ve süregelen bir mühendisliktir — ayrıca yalnızca ABD'ye özgüdür ve bildirim ritmindedir, sorgu için biçimlendirilmemiştir.
•API Pick Financials Search, ABD şirketlerinin beş temelini de tek bir POST endpoint'inin arkasında döndürür — çağrı başına 200 kredi, yalnızca-başarıda — bir LLM'in akıl yürütmesi için önceden biçimlendirilmiş.
•İçeriden işlemler (Form 4) ve temettü geçmişi az kullanılan sinyallerdir: burada çekmesi ucuz, EDGAR'dan derlemesi zahmetlidir.
•Tam bir temellendirilmiş görünüm için Financials'ı SEC Filings (10-K/10-Q'nun niteliksel metni) ve Markets (fiyat) ile birleştirin.

Fiyat görüştür; temeller kanıttır

Bir piyasa verisi çağrısı, ajanınıza bir hisse senedinin ne kadara mal olduğunu söyler. Arkasındaki işin büyüyüp büyümediğini, borç içinde boğulup boğulmadığını ya da kendi yöneticileri tarafından sessizce satılıp satılmadığını söyleyemez. İşte bu temeller katmanıdır — ve bir araştırma ajanının "fiyat söylemek"ten "bir görüş oluşturmak"a geçtiği yer burasıdır.

Sinyalin büyük kısmını beş veri kümesi taşır: bilanço, gelir tablosu, nakit akış tablosu, temettü geçmişi ve içeriden işlemler.

EDGAR vergisi

Tüm bunlar SEC EDGAR'da kamuya açık ve ücretsizdir. İşin püf noktası XBRL'dir. company-facts JSON'u devasa ve tutarsızdır: aynı kavram bildirim sahipleri arasında farklı etiketlenir, yeniden düzenlemeler geçmişi bulandırır ve aşağı akıştaki herhangi bir şeyin onu kullanabilmesinden önce dağınık bir taksonomiyi temiz bir şemaya eşlemeniz gerekir. İçeriden verileri (Form 4) ve temettüler, kendi başınıza ayrıştırdığınız ayrı bildirim türleridir. Bunu tek bir sembol için bir kez yapmak bir hafta sonudur; herhangi bir şirketi sorgulayan bir ajan için bunu güvenilir biçimde yapmak ise bakımı yapılan bir pipeline'dır.

Tek bir araç olarak temeller

Financials Search, ABD halka açık şirketleri için bilançoları, gelir tablolarını, nakit akışını, temettüleri ve içeriden işlemleri tek bir POST endpoint'inin arkasında döndürür — çağrı başına 200 kredi, yalnızca-başarıda, bir LLM için önceden biçimlendirilmiş.

import httpx, os
API, HEADERS = "https://api.apipick.com/v1", {"x-api-key": os.environ["APIPICK_KEY"]}

def fundamentals(query: str):
    return httpx.post(f"{API}/search/financials", headers=HEADERS,
                      json={"query": query}).json()["results"]

fundamentals("Apple latest balance sheet and cash flow")
fundamentals("recent insider transactions at Meta")
fundamentals("Microsoft revenue and net income trend")

EDGAR vs. sağlayıcı vs. paket

	SEC EDGAR'ı ayrıştırmak	Tablo-API sağlayıcısı	API Pick Financials
Maliyet	Ücretsiz + mühendislik	Abonelik	Çağrı başına 200 kredi, yalnızca başarıda
Kurulum	XBRL normalleştirme pipeline'ı	Tipli endpoint'leri entegre etmek	Tek endpoint, tek biçim
Kapsam	ABD, bildirime göre düzenli	Derin, uzun geçmiş	ABD temelleri + içeridekiler + temettüler
Sorgu tarzı	Bildirime/kavrama göre	Tipli parametreler	Doğal dil
En uygun olduğu durum	Tek seferlik / tam kontrol	Ürünün kendisi temeller	Finans ajanları (birçok araçtan biri)

Tam tablo

Temeller, niteliksel taraf (risk faktörleri, MD&A, kazanç çağrısı dili) için SEC Filings Search ile ve fiyat için Markets Search ile doğal biçimde eşleşir. Birlikte, yatırım araştırması ajanının belkemiğini oluştururlar. Tek anahtar, baştan sona JSON, yalnızca-başarıda. 100 kredi ile ücretsiz başlayın, kart gerekmez.

Sıkça Sorulan Sorular

Temelleri SEC EDGAR'dan ücretsiz alamaz mıyım?

Alabilirsiniz — EDGAR'ın company-facts ve XBRL verileri ücretsiz ve yetkilidir. Bedeli mühendisliktir: XBRL etiketleri bildirim sahipleri ve dönemler arasında kayar, yeniden düzenlemeler geçmişi karmaşıklaştırır ve bir model (veya bir grafik) bunları kullanmadan önce binlerce taksonomi kavramını temiz bir şemaya eşlemeniz gerekir. Ayrıca yalnızca ABD'ye özgüdür ve soruya göre değil, bildirime göre düzenlenmiştir. Ara sıra tek bir şirket için EDGAR yeterlidir. Birçok şirketi doğal dilde sorgulayan bir ajan için normalleştirilmiş bir API haftalar kazandırır.

Neler kapsanıyor — ve yalnızca ABD'ye mi özgü?

ABD'de listelenen halka açık şirketler için bilançolar, gelir tabloları, nakit akış tabloları, temettü geçmişi ve içeriden işlemler. Bunlar ABD temelleridir; ABD dışı ihraççılar için farklı bir kaynak kullanırsınız. Bildirim metninin kendisi için (10-K risk faktörleri, 10-Q MD&A, kazanç çağrıları) ayrı SEC Filings Search endpoint'ini kullanın.

İçeriden işlemleri ve temettüleri öne çıkarmaya neden değer?

Yüksek sinyallidirler ve kendiniz derlemesi can sıkıcıdır. İçeriden alım/satım (SEC Form 4) yakından izlenen davranışsal bir sinyaldir; temettü geçmişi gelir ve kalite taramaları için önemlidir. Her ikisi de EDGAR'dan belirli bildirim türlerini ayrıştırmayı gerektirir. Burada bunlar tablolarla aynı endpoint'te birinci sınıf alanlardır.

Bu, finansal tablo API sağlayıcılarına kıyasla nasıl?

Özel sağlayıcılar (örneğin finansal tablo API'leri) derin, tipli endpoint'ler ve uzun geçmiş sunar — temeller tüm ürününüzse harikadır. API Pick'in bakış açısı farklıdır: temeller, tek bir anahtarın arkasında bir paket (piyasalar, SEC, ekonomik, haberler) içindeki birçok araçtan biri olarak, bir ajanın sorgusu için biçimlendirilmiş, yalnızca-başarıda faturalandırılır. Bir temeller ürünü yerine bir finans ajanı kuruyorsanız, paket-tek-biçimde daha hızlı yoldur.

Bu bir yatırım tavsiyesi mi?

Hayır. Bu, araştırma ve ajan temellendirmesi için yapılandırılmış kamuya açık finansal veridir. Nitelikli bir kişinin veya denetlenen bir ajanın analizine bilgi sağlar; tavsiye değildir ve insan sorumluluğu ile risk kontrolleri olmadan otomatik alım satımı yönlendirmemelidir.