[ blog · comparison ]9 min read

API voor bedrijfsfundamentals: balans, kasstroom en insidertransacties voor finance-agents

Sarah ChoyGepubliceerd op 16 juni 20269 min leestijd

Prijzen vertellen je wat de markt denkt; fundamentals vertellen je of de markt gelijk heeft. Hier is een fundamentals-API gevormd voor AI-agents — overzichten, dividenden en insidertransacties in één endpoint — en hoe het zich verhoudt tot ruw SEC EDGAR en de leveranciers van overzicht-API's.

TL;DR

•Fundamentals = de laag van 'is het bedrijf echt gezond': balans, winst-en-verliesrekening, kasstroom, dividenden, insidertransacties.
•Je kunt het gratis parsen uit SEC EDGAR (XBRL), maar XBRL normaliseren over indieners en periodes heen is echt, doorlopend engineeringwerk — en het is alleen VS en in het tempo van de indieningen, niet gevormd voor query's.
•API Pick Financials Search retourneert alle vijf de fundamentals van Amerikaanse bedrijven achter één POST-endpoint — 200 credits/aanroep, alleen-bij-succes — vooraf gevormd voor het redeneren van een LLM.
•Insidertransacties (Form 4) en dividendgeschiedenis zijn de onderbenutte signalen: hier goedkoop op te halen, pijnlijk om uit EDGAR samen te stellen.
•Combineer Financials met SEC Filings (kwalitatieve tekst van 10-K/10-Q) en Markets (prijs) voor een volledig gefundeerd beeld.

Prijs is een mening; fundamentals zijn bewijs

Een marktdata-aanroep vertelt je agent wat een aandeel kost. Het kan je niet vertellen of het bedrijf erachter groeit, verdrinkt in schulden, of stilletjes wordt verkocht door zijn eigen leidinggevenden. Dat is de fundamentals-laag — en daar gaat een onderzoeksagent van "noteert prijzen" naar "vormt een mening".

Vijf datasets dragen het grootste deel van het signaal: de balans, de winst-en-verliesrekening, het kasstroomoverzicht, de dividendgeschiedenis en de insidertransacties.

De EDGAR-belasting

Dit alles is openbaar en gratis in SEC EDGAR. De adder onder het gras is XBRL. De company-facts-JSON is enorm en inconsistent: hetzelfde concept wordt verschillend getagd over indieners heen, herzieningen vertroebelen de historie, en je moet een uitwaaierende taxonomie op een schoon schema mappen voordat iets verderop in de keten het kan gebruiken. Insidergegevens (Form 4) en dividenden zijn aparte indieningstypen die je op zichzelf parst. Dit één keer doen voor één ticker is een weekend; het betrouwbaar doen voor een agent die elk bedrijf bevraagt, is een onderhouden pipeline.

Fundamentals als één tool

Financials Search retourneert balansen, winst-en-verliesrekeningen, kasstroom, dividenden en insidertransacties voor Amerikaanse beursgenoteerde bedrijven achter één POST-endpoint — 200 credits per aanroep, alleen-bij-succes, vooraf gevormd voor een LLM.

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. leverancier vs. suite

	SEC EDGAR parsen	Leverancier van overzicht-API's	API Pick Financials
Kosten	Gratis + engineering	Abonnement	200 credits/aanroep, alleen bij succes
Opzet	XBRL-normalisatiepipeline	Getypeerde endpoints integreren	Eén endpoint, één vorm
Dekking	VS, per indiening georganiseerd	Diep, lange historie	VS-fundamentals + insiders + dividenden
Querystijl	Per indiening/concept	Getypeerde parameters	Natuurlijke taal
Beste voor	Eenmalig / volledige controle	Fundamentals als het product	Finance-agents (één tool van vele)

Het volledige plaatje

Fundamentals combineren van nature met SEC Filings Search voor de kwalitatieve kant (risicofactoren, MD&A, taal van earnings calls) en met Markets Search voor de prijs. Samen vormen ze de ruggengraat van de beleggingsonderzoek-agent. Eén sleutel, overal JSON, alleen-bij-succes. Begin gratis met 100 credits, zonder kaart.

Veelgestelde vragen

Kan ik fundamentals niet gewoon gratis uit SEC EDGAR halen?

Dat kan — de company-facts- en XBRL-gegevens van EDGAR zijn gratis en gezaghebbend. De kostenpost is engineering: XBRL-tags verschuiven over indieners en periodes, herzieningen maken de historie ingewikkeld, en je moet duizenden taxonomieconcepten op een schoon schema mappen voordat een model (of een grafiek) ze kan gebruiken. Het is bovendien alleen VS en georganiseerd per indiening, niet per vraag. Voor af en toe één bedrijf is EDGAR prima. Voor een agent die veel bedrijven in natuurlijke taal bevraagt, bespaart een genormaliseerde API weken.

Wat valt eronder — en is het alleen VS?

Balansen, winst-en-verliesrekeningen, kasstroomoverzichten, dividendgeschiedenis en insidertransacties voor in de VS genoteerde beursgenoteerde bedrijven. Het zijn Amerikaanse fundamentals; voor niet-Amerikaanse uitgevers zou je een andere bron gebruiken. Voor de indieningstekst zelf (risicofactoren in de 10-K, MD&A in de 10-Q, earnings calls) gebruik je het aparte SEC Filings Search-endpoint.

Waarom zijn insidertransacties en dividenden het benadrukken waard?

Ze zijn signaalrijk en vervelend om zelf samen te stellen. Insiderkoop/-verkoop (SEC Form 4) is een nauwlettend gevolgd gedragssignaal; dividendgeschiedenis is belangrijk voor inkomsten- en kwaliteitsscreens. Beide vereisen het parsen van specifieke indieningstypen uit EDGAR. Hier zijn het eersteklas velden in hetzelfde endpoint als de overzichten.

Hoe verhoudt dit zich tot leveranciers van API's voor financiële overzichten?

Gespecialiseerde leveranciers (bijv. API's voor financiële overzichten) geven diepe, getypeerde endpoints en een lange historie — geweldig als fundamentals je hele product zijn. De invalshoek van API Pick is anders: fundamentals als één tool binnen een suite (markten, SEC, economisch, nieuws) achter één sleutel, gevormd voor de query van een agent, gefactureerd alleen-bij-succes. Als je een finance-agent bouwt in plaats van een fundamentals-product, is de suite-in-één-vorm de snellere weg.

Is dit beleggingsadvies?

Nee. Het zijn gestructureerde, openbare financiële gegevens voor onderzoek en het funderen van agents. Het voedt de analyse van een gekwalificeerd persoon of een gesuperviseerde agent; het is geen advies en mag geen geautomatiseerde handel aansturen zonder menselijke verantwoording en risicocontroles.