Ga naar inhoud

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, of ticker:AAPL.XNAS om de beurs te specificeren
  • cik:320193, het bedrijfsnummer van de SEC
  • fmd_<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-30 op elke leesroute geeft terug wat op dat moment bekend was.
  • original=true geeft de eerste gerapporteerde versie van elke periode terug.
  • history=true geeft 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

RouteWat het teruggeeft
GET /v1/companiesBedrijvenoverzicht met filters en paginering
GET /v1/company/profileProfiel, vermeldingen en de beschikbare datasets
GET /v1/company/metricsDe conceptrijen van het sjabloon van het bedrijf
GET /v1/company/financials/{statement}/standardizedEen gestandaardiseerd overzicht
GET /v1/company/financials/{statement}/as_reportedDe eigen regels van de indiener met tags
GET /v1/company/ratiosRatio'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/filingsDe 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}/factsElk gekoppeld feit dat in een indiening bij de SEC (ingediend document) is getagd
GET /v1/filing/{accession}/documentLinks 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/insidersInsidertransacties uit Form 3, Form 4 en Form 5
GET /v1/company/ownership/institutionalForm 13F-houders van een bedrijf, per kwartaal
GET /v1/ownership/institutional/holdersForm 13F-managers
GET /v1/ownership/institutional/holdingsDe 13F-portefeuille van één manager voor een kwartaal
GET /v1/company/splitsAandelensplitsingen zoals ingediend, en of de prijzen deze bevestigen
GET /v1/company/dividendsDividenden per aandeel die in elke periode worden verklaard of uitbetaald, zoals ingediend
GET /v1/events_calendarWinstberichten (ingediende 8-K Item 2.02) en door het model verwachte datums
GET /v1/company/events8-K-items: een op indieningen bij de SEC (ingediende documenten) gebaseerde eventfeed
GET /v1/news8-K-indieningen van elk gedekt bedrijf, nieuwste eerst, met gebeurtenistypen en een belangrijkheidsniveau
GET /v1/news/feedFinancialMD's eigen eventfeed uit elk SEC-formulier met gebeurtenissen, met door regels gemaakte koppen, belangrijkheid en kerncijfers. Geen wire news
GET /v1/news/issuer_releasesReleases die uitgevende instellingen over zichzelf publiceerden: SEC-exhibits, plus kop en link uit de eigen feed van de uitgevende instelling
GET /v1/company/call_materialsEarnings 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_calendarEarnings calls zoals uitgevende instellingen die aankondigen in SEC-indieningen, met een link naar de eigen webcastpagina van de uitgevende instelling
GET /v1/search/filingsVolledige-tekstzoekopdracht in EDGAR-documenten sinds 2001 (SEC EDGAR full-text search)
GET /v1/coverageElke dataset met zijn status: beschikbaar, niet gedekt (gelicentieerd) of niet gebouwd, en wat je in plaats daarvan kunt gebruiken
GET /v1/company/estimatesFinancialMD'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/consensusNiet gedekt: consensusschattingen zijn gelicentieerd. Geeft 404 not_covered terug met alternatieven
GET /v1/company/analyst_ratingsNiet gedekt: analistenbeoordelingen zijn gelicentieerd. Geeft 404 not_covered terug
GET /v1/company/transcriptsNiet gedekt: call transcripts zijn gelicentieerd. Geeft 404 not_covered terug
GET /v1/company/stock_prices/intradayNiet beschikbaar: realtime- en intradayprijzen zijn gelicentieerd. Geeft 404 not_covered terug
GET /v1/company/logoEen logo om het bedrijf te identificeren: een openlijk gelicentieerd bestand met de naamvermelding, of een gegenereerde tegel. JSON, SVG of PNG
GET /v1/politician_tradesTransacties 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/segmentsSegmentgegevens zoals gerapporteerd (bedrijf, geografie, product)
GET /v1/company/ownership/insider_holdersWat elke insider bezat na hun laatste Form 4 of 5
GET /v1/company/ownership/fundsFondsen die het bedrijf in hun laatste N-PORT houden
GET /v1/fundsN-PORT fondsen met hun laatste rapport
GET /v1/fund/holdingsDe N-PORT-posities van één fonds
GET /v1/company/kpisDoor het bedrijf gerapporteerde aangepaste en operationele kengetallen, elk met bronverwijzing
GET /v1/company/dividend_eventsContante dividenden met hun data zoals ingediend
GET /v1/company/ownership/insider_holdingsPositieregels uit Form 3, 4 en 5
GET /v1/fund/profileHet type van een fonds uit N-CEN en de kosten van de aandelenklassen
GET /v1/fund/navDe 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/xrefGegeven één identificatiecode: het bedrijf of fonds waar die naar verwijst en de andere open identificatiecodes, elk met bron
GET /v1/identifiers/masterOpen identificatiecodes van elk bedrijf, gepagineerd
GET /v1/company/stock_prices/returnsKoersrendement, totaalrendement en maximale drawdown over standaardvensters, berekend uit end-of-day bars en bij de SEC ingediende splits en dividenden
GET /v1/company/identifiersLEI en FIGI met bewijs
GET /v1/company/stock_pricesDagelijkse 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/screenScreen elk gedekt bedrijf op statistieken over de meest recente periode
POST /v1/verifyControleer een getal aan de hand van de ingediende waarde
GET /v1/changesFeiten waarvan de kennis sinds een bepaald tijdstip beschikbaar is gekomen
POST /v1/request-dataVertel 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-dataDe 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/requestedAangevraagd en geleverd: beoordeelde verzoeken met aantallen, geen gegevens van indieners
GET /proof/{id}Het bewijs voor een geleverde waarde
GET /v1/company/line_itemsEén gerapporteerde regel per label en periode: details zoals gerapporteerd, segmentcijfers, bedrijfsstatistieken en guidance
GET /v1/screen/nlEen 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/askEen 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/summaryEen 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/forwardForward waarderingsratio's op onze eigen modelgebaseerde schattingen (gelabelde modeloutput, nooit consensus), met de schatting, het interval en de trackrecord
GET /v1/company/technicalsTechnische indicatoren (voortschrijdende gemiddelden, RSI, MACD, Bollinger-banden, ATR, sluitingsbereik) berekend uit dagelijkse bars van één handelsplaats en SEC-filed splits
GET /v1/pre_ipoBedrijven 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_ratesDagelijkse 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/researchOnafhankelijke 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/feedbackVertel 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-errorsMeld 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/mcp

De 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.