API- en MCP-documentatie
FinancialMD levert jaarrekeningen op basis van indieningen bij de SEC (ingediende documenten). Elk getal linkt naar de indiening bij de SEC (het ingediende document) waar het vandaan komt, en elk getal kan worden gelezen zoals het op elke datum bekend was. Er is geen account nodig.
Doe een eerste aanvraag
De API is JSON over HTTPS. Deze call geeft Apple's laatste vijf jaarlijkse winst-en-verliesrekeningen terug. Er is geen sleutel nodig.
curl "https://api.financial.md/v1/company/financials/income_statement/standardized?company=ticker:AAPL&period_type=annual&limit=5"Het overzicht is een van income_statement, balance_sheet, cash_flow of supplemental. Het periodetype is een van annual, quarterly, ltm of ytd.
Noem een bedrijf
Elke bedrijfsroute gebruikt een parameter company.
ticker:AAPL, ofticker:AAPL.XNASom de beurs te specificerencik:320193, het bedrijfsnummer van de SECfmd_<id>, de id die FinancialMD aan het bedrijf geeft
Een losse AAPL wordt gelezen als een ticker en losse cijfers als een CIK. Het antwoord zegt wat overeenkwam in meta.company.matched_by.
Lees een waarde
Een geslaagd antwoord is { data, meta }. Een getal binnen data staat nooit los. Het is een waardeobject:
{
"value": 391035000000,
"unit": "USD",
"currency": "USD",
"decimals": -6,
"period": { "start": "2023-10-01", "end": "2024-09-28", "type": "annual", "fiscal_year": 2024, "fiscal_period": "FY" },
"known": { "from": "YYYY-MM-DDThh:mm:ssZ", "to": null },
"restated": false,
"method": "as_filed",
"calc_type": "as_filed",
"proof": { "id": "p_...", "accession": "0000320193-24-000123", "form": "10-K", "filed": "2024-11-01", "taxonomy": "us-gaap", "tag": "...", "source_url": "https://www.sec.gov/..." }
}known is de periode waarin dit het meest recent ingediende cijfer was. restated is alleen true wanneer een latere indiening bij de SEC (ingediend document) het cijfer heeft herzien; restatement_kind zegt dan hoe. proof.id wordt via GET /proof/{id} omgezet naar de indiening bij de SEC (ingediend document) en de ruwe feiten achter de waarde.
Lees het verleden zoals het bekend was
as_of=2024-06-30op elke leesroute geeft terug wat op dat moment bekend was.original=truegeeft de eerste gerapporteerde versie van elke periode terug.history=truegeeft elke versie van elke periode terug, de oudste eerst.GET /v1/changes?since=<timestamp>geeft een lijst van feiten die sindsdien bekend zijn geworden.
Routes
| Route | Wat het teruggeeft |
|---|---|
GET /v1/companies | Bedrijvenoverzicht met filters en paginering |
GET /v1/company/profile | Profiel, vermeldingen en de beschikbare datasets |
GET /v1/company/metrics | De conceptrijen van het sjabloon van het bedrijf |
GET /v1/company/financials/{statement}/standardized | Een gestandaardiseerd overzicht |
GET /v1/company/financials/{statement}/as_reported | De eigen regels van de indiener met tags |
GET /v1/company/ratios | Ratio's berekend uit de overzichten, met bewijs van hun invoer |
GET /v1/company/ratios/daily/{ratio_id} | Eén ratio als reeks over perioden |
GET /v1/company/filings | De index van de indieningen bij de SEC (ingediende documenten) van een bedrijf |
GET /v1/filing/{accession} | Eén indiening bij de SEC (ingediend document) |
GET /v1/filing/{accession}/facts | Elk gekoppeld feit dat in een indiening bij de SEC (ingediend document) is getagd |
GET /v1/filing/{accession}/document | Links naar de pagina's van een indiening bij de SEC (ingediend document) op EDGAR, of naar het primaire document als HTML, PDF of pagina-afbeeldingen |
GET /v1/company/ownership/insiders | Insidertransacties uit Form 3, Form 4 en Form 5 |
GET /v1/company/ownership/institutional | Form 13F-houders van een bedrijf, per kwartaal |
GET /v1/ownership/institutional/holders | Form 13F-managers |
GET /v1/ownership/institutional/holdings | De 13F-portefeuille van één manager voor een kwartaal |
GET /v1/company/splits | Aandelensplitsingen zoals ingediend, en of de prijzen deze bevestigen |
GET /v1/company/dividends | Dividenden per aandeel die in elke periode worden verklaard of uitbetaald, zoals ingediend |
GET /v1/events_calendar | Winstberichten (ingediende 8-K Item 2.02) en door het model verwachte datums |
GET /v1/company/events | 8-K-items: een op indieningen bij de SEC (ingediende documenten) gebaseerde eventfeed |
GET /v1/news | 8-K-indieningen van elk gedekt bedrijf, nieuwste eerst, met gebeurtenistypen en een belangrijkheidsniveau |
GET /v1/news/feed | FinancialMD's eigen eventfeed uit elk SEC-formulier met gebeurtenissen, met door regels gemaakte koppen, belangrijkheid en kerncijfers. Geen wire news |
GET /v1/news/issuer_releases | Releases die uitgevende instellingen over zichzelf publiceerden: SEC-exhibits, plus kop en link uit de eigen feed van de uitgevende instelling |
GET /v1/company/call_materials | Earnings call-materialen die de uitgever bij de SEC heeft ingediend: persberichten, voorbereide opmerkingen, brieven, presentaties en een transcript als dat is ingediend |
GET /v1/call_material/{id} | Eén door de uitgever ingediend document als passages met secties, sprekerbeurten en onderwerptags |
GET /v1/calls_calendar | Earnings calls zoals uitgevende instellingen die aankondigen in SEC-indieningen, met een link naar de eigen webcastpagina van de uitgevende instelling |
GET /v1/search/filings | Volledige-tekstzoekopdracht in EDGAR-documenten sinds 2001 (SEC EDGAR full-text search) |
GET /v1/coverage | Elke dataset met zijn status: beschikbaar, niet gedekt (gelicentieerd) of niet gebouwd, en wat je in plaats daarvan kunt gebruiken |
GET /v1/company/estimates | FinancialMD's eigen modelgebaseerde basisramingen met intervallen en een op peildatum (point-in-time) trackrecord, de guidance van het bedrijf zoals vermeld in zijn indieningen bij de SEC (ingediende documenten), en beschrijvende signalen. Geen consensus, geen analistenramingen. Zie de methode |
GET /v1/company/estimates/consensus | Niet gedekt: consensusschattingen zijn gelicentieerd. Geeft 404 not_covered terug met alternatieven |
GET /v1/company/analyst_ratings | Niet gedekt: analistenbeoordelingen zijn gelicentieerd. Geeft 404 not_covered terug |
GET /v1/company/transcripts | Niet gedekt: call transcripts zijn gelicentieerd. Geeft 404 not_covered terug |
GET /v1/company/stock_prices/intraday | Niet beschikbaar: realtime- en intradayprijzen zijn gelicentieerd. Geeft 404 not_covered terug |
GET /v1/company/logo | Een logo om het bedrijf te identificeren: een openlijk gelicentieerd bestand met de naamvermelding, of een gegenereerde tegel. JSON, SVG of PNG |
GET /v1/politician_trades | Transacties van leden van het Amerikaanse Huis van Afgevaardigden zoals gerapporteerd in periodieke transactierapporten, zoals ingediend, met het officiële rapport. Nooit geprijsd. Gebruik is beperkt door 5 U.S.C. 13107(c)(1): lees data.notice |
GET /v1/company/segments | Segmentgegevens zoals gerapporteerd (bedrijf, geografie, product) |
GET /v1/company/ownership/insider_holders | Wat elke insider bezat na hun laatste Form 4 of 5 |
GET /v1/company/ownership/funds | Fondsen die het bedrijf in hun laatste N-PORT houden |
GET /v1/funds | N-PORT fondsen met hun laatste rapport |
GET /v1/fund/holdings | De N-PORT-posities van één fonds |
GET /v1/company/kpis | Door het bedrijf gerapporteerde aangepaste en operationele kengetallen, elk met bronverwijzing |
GET /v1/company/dividend_events | Contante dividenden met hun data zoals ingediend |
GET /v1/company/ownership/insider_holdings | Positieregels uit Form 3, 4 en 5 |
GET /v1/fund/profile | Het type van een fonds uit N-CEN en de kosten van de aandelenklassen |
GET /v1/fund/nav | De nettoactiva van een fonds per rapportmaand, het gerapporteerde maandelijkse rendement van elke klasse met onze rendementindex, en de NAV per aandeel van closed-end funds, uit SEC indieningen. Dagelijkse NAV wordt niet geleverd |
GET /v1/identifiers/xref | Gegeven één identificatiecode: het bedrijf of fonds waar die naar verwijst en de andere open identificatiecodes, elk met bron |
GET /v1/identifiers/master | Open identificatiecodes van elk bedrijf, gepagineerd |
GET /v1/company/stock_prices/returns | Koersrendement, totaalrendement en maximale drawdown over standaardvensters, berekend uit end-of-day bars en bij de SEC ingediende splits en dividenden |
GET /v1/company/identifiers | LEI en FIGI met bewijs |
GET /v1/company/stock_prices | Dagelijkse bars opgebouwd uit alleen transacties op IEX. Niet de geconsolideerde tape. Standaard raw; adjust=splits of adjust=total_return voegt aangepaste waarden toe |
GET /v1/screen | Screen elk gedekt bedrijf op statistieken over de meest recente periode |
POST /v1/verify | Controleer een getal aan de hand van de ingediende waarde |
GET /v1/changes | Feiten waarvan de kennis sinds een bepaald tijdstip beschikbaar is gekomen |
POST /v1/request-data | Vertel ons welke gegevens je nodig had en niet hebt gevonden. Geen sleutel, nooit in rekening gebracht, wekelijks beoordeeld. Zie hoe je gegevens aanvraagt |
GET /v1/request-data | De body van POST /v1/request-data bevat |
GET /v1/request-data/{id} | De status van een verzoek: nieuw, beoordeeld, gepland, afgerond of wontfix |
GET /v1/requested | Aangevraagd en geleverd: beoordeelde verzoeken met aantallen, geen gegevens van indieners |
GET /proof/{id} | Het bewijs voor een geleverde waarde |
GET /v1/company/line_items | Eén gerapporteerde regel per label en periode: details zoals gerapporteerd, segmentcijfers, bedrijfsstatistieken en guidance |
GET /v1/screen/nl | Een screen in gewone taal: de vraag wordt ontleed in screenfilters (door een AI-model of door vaste regels, gelabeld) en uitgevoerd als GET /v1/screen |
GET /v1/ask | Een door AI geschreven antwoord over één bedrijf op basis van zijn eigen ingediende waarden, waarbij elk getal wordt gecontroleerd aan de hand van de aangehaalde feiten |
GET /v1/news/summary | Een door AI geschreven samenvatting van op SEC-indieningen gebaseerd nieuws van één dag, of van de recente gebeurtenissen van één bedrijf, uit FinancialMD's eigen eventfeed; elke bullet verwijst naar de indieningen en elk getal is eraan getoetst |
GET /v1/company/ratios/forward | Forward waarderingsratio's op onze eigen modelgebaseerde schattingen (gelabelde modeloutput, nooit consensus), met de schatting, het interval en de trackrecord |
GET /v1/company/technicals | Technische indicatoren (voortschrijdende gemiddelden, RSI, MACD, Bollinger-banden, ATR, sluitingsbereik) berekend uit dagelijkse bars van één handelsplaats en SEC-filed splits |
GET /v1/pre_ipo | Bedrijven die een beursgang hebben aangevraagd: registranten met een S-1 of F-1 on file vóór enig periodiek rapport, met status, voorgestelde ticker en data |
GET /v1/pre_ipo/{cik} | Eén pre-IPO registrant: status en bijbehorende regel, registratie-indieningen, de financiële cijfers die het tagde en de aanbiedingsvoorwaarden zoals gelezen uit het prospectus |
GET /v1/fx_rates | Dagelijkse referentiewisselkoersen uit de openbare bestanden van de Europese Centrale Bank, elke geleverde valuta ten opzichte van een andere via de euro; referentiekoersen, geen verhandelbare quotes |
GET /v1/research | Onafhankelijke onderzoeksrapporten met CC BY 4.0-licentie, ook zonder kosten leesbaar op de site van de uitgever: zoek op bedrijf, collectie, taal, woorden en datum, elk met een samenvatting in de eigen woorden van het rapport |
GET /v1/research/{id} | Eén onderzoeksrapport volledig als gestructureerde Markdown: secties, tickers, datum, bronnen, licentie en de bronvermelding die je moet behouden bij het citeren |
POST /v1/feedback | Vertel ons wat werkte en wat niet: een opmerking, een beoordeling of redenen. Geen sleutel, nooit kosten. GET /v1/feedback beschrijft de body |
POST /v1/data-errors | Meld een getal waarvan u denkt dat het onjuist is. Het wordt meteen vergeleken met wat wij aanbieden en dagelijks met de indiening bij de SEC (ingediend document). Volg dit met GET /v1/data-errors/{id} |
Het OpenAPI document bevat elke parameter en elk responsschema. Het llms.txt, llms-full.txt en vaardigheidsbestand zeggen hetzelfde voor agenten; https://api.financial.md/docs is de interactieve referentie en https://api.financial.md/changelog geeft wijzigingen weer.
Controleer een getal
curl -X POST "https://api.financial.md/v1/verify" -H "content-type: application/json" \
-d '{"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}'Het antwoord heeft een verdict van matches, differs of unknown, de ingediende waarde met bewijs, het verschil en een scale_hint wanneer je getal met een macht van tien afwijkt.
Grenzen
Oproepen zonder sleutel zijn beperkt per IP-adres, per dag.
- 10 gemeten oproepen: ratio's, screener, verifiëren en elke route met een prijs, zoals gestandaardiseerde jaarrekeningen, segmenten en KPI's
- 1,000 leesacties op het niveau van indieningen bij de SEC (ingediende documenten): gerapporteerde feiten, indieningen, eigendom en prijzen
- 1,000 metadata-leesacties: directory, profielen, kengetallen, bewijs en wijzigingen
Elk antwoord bevat RateLimit-Limit, RateLimit-Remaining en RateLimit-Reset. Een 429 bevat Retry-After.
Oproepen op api.financial.md zonder sleutel worden nooit in rekening gebracht. API-sleutels zijn inbegrepen bij de Terminal + Agent-plannen; zie API-sleutels. Agenten kunnen ook per oproep betalen op agent.financial.md. Zie Prijzen.
Wat wordt gedekt
De dekking omvat bedrijven die bij de SEC indienen en vandaag op een Amerikaanse beurs genoteerd zijn.
- Gestandaardiseerde overzichten bestaan voor indieners die rapporteren onder US GAAP.
- Indieners die onder IFRS rapporteren, zoals veel buitenlandse bedrijven die Form 20-F of 40-F indienen, hebben indieningen bij de SEC (ingediende documenten) maar nog geen gestandaardiseerde overzichten.
- Bedrijven die van de beurs zijn gehaald staan in de directory met hun overzichten en indieningen. Zoek ze op via CIK: ze hebben geen ticker-lookup en geen prijzen, dus de prijsgeschiedenis omvat alleen bedrijven die vandaag genoteerd zijn.
- Eigendomgegevens komen uit indieningen sinds 1 juli 2026 en worden elke dag om 13:00 UTC bijgewerkt vanuit de dagelijkse index van EDGAR: insidertransacties uit Form 3, Form 4 en Form 5 van gedekte bedrijven, en elke Form 13F-HR, zodat de 13F-rapporten van een nieuw kwartaal binnenkomen zodra beheerders ze indienen. Een 13F-positie wordt alleen aan een bedrijf gekoppeld wanneer een Schedule 13D- of 13G-omslag het effect bij naam noemt. Voor het kwartaal eindigend op 30 juni 2026 koppelt dit 80 procent van de gerapporteerde waarde; de andere posities verschijnen in de portefeuille van een beheerder onder de naam van de emittent zoals ingediend.
- Consensusramingen en transcripties van winstgesprekken worden niet aangeboden: beide zijn gelicentieerde data. Segmenten worden aangeboden zoals gerapporteerd, en nieuws is de feed van 8-K-indieningen.
Wanneer een bedrijf bekend is maar een dataset ontbreekt, antwoordt de API not_covered en vermeldt zij welke datasets wel beschikbaar zijn.
MCP server
De MCP-server verpakt dezelfde API in 57 alleen-lezen tools. Hij spreekt MCP Streamable HTTP en heeft geen account nodig.
https://mcp.financial.md/mcpDe MCP gids somt de tools op. De serverkaart is voor registries.
Fouten
Een fout is { "error": { code, message, docs, request_id, remedies } }. De lijst remedies geeft aan wat je daarna moet doen. De foutenreferentie legt elke code uit.