[ blog · tutorial ]12 min read

Yatırım Araştırma Ajanı Nasıl Kurulur: Piyasalar, Temeller, SEC ve Ekonomik Veriler Tek Bir API'de

Sarah Choy·Yayımlanma tarihi: 16 Haziran 2026·12 dk okuma

Bir yatırım-araştırma ajanı beş farklı veri katmanına ihtiyaç duyar — fiyatlar, temeller, dosyalamalar, makro ve haberler — her biri genelde ayrı bir sağlayıcı, anahtar ve şema. İşte beşini de tek bir endpoint kümesinin arkasına bağlamanın yolu; çalışan kod ve maliyet hesabıyla birlikte.

Özet

• •Faydalı bir finans ajanı beş veri katmanına ihtiyaç duyar: gerçek zamanlı piyasalar (fiyatlar), şirket temelleri (tablolar), SEC dosyalamaları, ekonomik göstergeler ve haberler. Ayrı sağlayıcılardan birleştirildiğinde bu 5 sözleşme, 5 anahtar ve 5 şemadır.
• •API Pick beşini de tutarlı JSON arama endpoint'leri olarak sunar — /search/markets, /search/financials, /search/sec, /search/economic, /search/news — artı tam belgeler için /extract. Tek anahtar, LLM tool calling için önceden biçimlendirilmiş.
• •Ajan deseni: ilgili endpoint'leri tool olarak paralel çalıştır, JSON'u birleştir ve modelin rakamları uydurmak yerine temellendirilmiş veri üzerinde akıl yürütmesine izin ver.
• •Kredi fiyatlandırması yalnızca-başarıda: çağrı başına markets 120, financials 200, sec 120, economic 50, news 15. Tipik bir çok-araçlı araştırma turu derinliğe göre $0.01–$0.10'un epeyce altına mal olur.
• •Kur-mu-al-mı: Polygon + bir temeller sağlayıcısı + SEC EDGAR + FRED + bir haber API'sini kendin birleştirmek haftalarca entegrasyon ve 5 aylık fatura demektir; tek-endpoint yolu bir gün.

Beş katman sorunu

Bir LLM'e "NVIDIA şu an pahalı mı?" diye sor; tam bir özgüvenle bir F/K oranı uyduracaktır. Çözüm daha büyük bir model değil — temellendirmedir. Güven kazanan bir araştırma ajanı, beş katman boyunca canlı ve alıntılanmış veri çekmek, sonra onun üzerinde akıl yürütmek zorundadır:

• Piyasalar — güncel fiyat, piyasa değeri ve nasıl hareket ettiği. İlgili olduğunda kripto, forex, ETF'ler ve günün en çok hareket edenleri.
• Temeller — bilanço, gelir tablosu, nakit akışı, temettüler ve içeriden işlemler. "İş gerçekten sağlıklı mı" katmanı.
• SEC dosyalamaları — 10-K risk faktörleri, 10-Q ayrıntısı, 8-K olayları, kazanç çağrılarının dili. Rakamların kaçırdığı niteliksel boyut.
• Ekonomik göstergeler — FRED, BLS, Dünya Bankası ve IMF'den faizler, enflasyon, istihdam, GSYİH. Her tezin içinde durduğu makro arka plan.
• Haberler — zamanında katalizör: bir not indirimi, bir ürün lansmanı, bir düzenleyici işlem.

Ayrı sağlayıcılardan birleştirildiğinde, bu beş sözleşme, beş API anahtarı, beş rate-limit rejimi ve bir model dokunmadan önce normalleştirmen gereken beş yanıt şemasıdır. Finans-ajanı projeleri tam da entegrasyonda takılır.

Tek endpoint kümesi, beş katman

API Pick her katmanı tutarlı bir JSON arama endpoint'i olarak sunar, böylece ajan tek bir anahtar ve tek bir yanıt biçimiyle konuşur:

• Markets Search — küresel ve ABD hisse senetleri, kripto, forex, ETF'ler, fonlar, emtialar ve ABD'nin en çok hareket eden hisseleri.
• Financials Search — bilançolar, gelir tabloları, nakit akışı, temettüler, içeriden işlemler.
• SEC Filings Search — 10-K/10-Q/8-K, kazanç çağrısı transkriptleri, hisse senedi istatistikleri.
• Economic Data Search — FRED, BLS, Dünya Bankası, IMF, USAspending, Destatis.
• News Search — büyük medya organlarından tarih filtreli haberler.
• Extract — bir alıntı yeterli olmadığında tam bir dosyalamayı veya makaleyi temiz markdown'a çek.

Ajan mimarisi

Her endpoint'i bir tool olarak kaydet. Bir soru geldiğinde, ajan hangi katmanlara ihtiyaç duyduğuna karar verir, onları paralel olarak çağırır, JSON'u birleştirir ve temellendirilmiş sonuç üzerinde akıl yürütür. Bir hisse koduyla ilgili soru markets + temeller + haberlere dokunur; "sektör nasıl konumlanmış" sorusu economic + haberler + birkaç kıyaslanabilire dokunur.

import asyncio, httpx, os

API = "https://api.apipick.com/v1"
HEADERS = {"x-api-key": os.environ["APIPICK_KEY"], "Content-Type": "application/json"}

async def search(client, path, query, **kw):
    r = await client.post(f"{API}/{path}", headers=HEADERS,
                          json={"query": query, **kw})
    r.raise_for_status()
    return r.json()["results"]

async def research(ticker: str):
    async with httpx.AsyncClient(timeout=30) as c:
        markets, fundamentals, filings, macro, news = await asyncio.gather(
            search(c, "search/markets",    f"{ticker} price and market cap"),
            search(c, "search/financials", f"{ticker} latest balance sheet and cash flow"),
            search(c, "search/sec",        f"{ticker} 10-K risk factors", end_date="2026-06-16"),
            search(c, "search/economic",   "US interest rates and inflation latest"),
            search(c, "search/news",       f"{ticker} latest news", end_date="2026-06-16"),
        )
    return {"markets": markets, "fundamentals": fundamentals,
            "filings": filings, "macro": macro, "news": news}

# Feed the merged JSON back to your LLM as grounding, with the source URLs,
# and ask it to synthesize — never to recall numbers.
context = asyncio.run(research("NVDA"))

Her sonuç bir source URL'si taşır. Bunları nihai yanıta kadar geçir ki bir insan her iddiayı denetleyebilsin — ve ajanın çıktısı alıntılanabilir olsun, gerçek bir iş akışında onu faydalı kılan da budur.

Kur mu, al mı

Tek bir veri türü için doğrudan gitmek makuldür. Beşine de ihtiyaç duyan ve öngörülemez biçimde keşfeden bir ajan için tek-endpoint yolu bir günde yayına girer ve yalnızca bir çağrı başarılı olduğunda faturalandırır.

Bunun açtığı kapılar

Aynı beş tool, hisse kodu aramalarından çok daha fazlasına güç verir: kazanç sezonu brifing ajanları, temellere dayanan sektör taramaları, makro-bilinçli portföy yorumları ve Extract aracılığıyla gerçek 10-K'yi okuyan inceleme asistanları. Desen her zaman aynıdır — temellendirilmiş tool çağrıları, paralel geri getirme, kaynakları iliştirilmiş gerçek veri üzerinde sentez.

Ücretsiz bir anahtarla (100 kredi, kart gerekmez) başla ve beş tool'u tercih ettiğin ajan çerçevesine bağla. Oradan sonrası prompt mühendisliğidir, tesisat değil.

Yazan

Sarah Choy

CEO, API Pick

Sarah Choy, API Pick'in CEO'sudur. Yapay zeka ajanları ve LLM iş akışları için üretime hazır API'ler geliştirme üzerine yazılar yazar.