Hoppa till innehållet

API- och MCP-dokumentation

FinancialMD tillhandahåller finansiella rapporter byggda från inlämningar till SEC (inlämnade dokument). Varje siffra länkar till den inlämning till SEC (det inlämnade dokumentet) den kom från, och varje siffra kan läsas så som den var känd vid valfritt datum. Inget konto behövs.

Gör ett första anrop

API är JSON över HTTPS. Detta anrop returnerar Apples fem senaste årliga resultaträkningar. Det behövs ingen nyckel.

curl "https://api.financial.md/v1/company/financials/income_statement/standardized?company=ticker:AAPL&period_type=annual&limit=5"

Rapporten är en av income_statement, balance_sheet, cash_flow eller supplemental. Periodtypen är en av annual, quarterly, ltm eller ytd.

Nämn ett företag

Varje företagsrutt tar parametern company.

  • ticker:AAPL, eller ticker:AAPL.XNAS för att namnge börsen
  • cik:320193, SECföretagsnummer
  • fmd_<id>, id:t FinancialMD ger företaget

Ett fristående AAPL läses som en ticker och fristående siffror som en CIK. Svaret anger vad som matchade i meta.company.matched_by.

Läs ett värde

Ett lyckat svar är { data, meta }. Ett tal inuti data är aldrig fristående. Det är ett värdeobjekt:

{
  "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 är tidsintervallet under vilket detta var den senast inlämnade siffran. restated är sant endast när en senare inlämning till SEC (inlämnat dokument) ändrade siffran; restatement_kind anger då hur. proof.id slås upp via GET /proof/{id} till inlämningen till SEC (det inlämnade dokumentet) och de råa fakta bakom värdet.

Läs det förflutna som det var känt

  • as_of=2024-06-30 på vilken läsrutt som helst returnerar det som var känt vid det tillfället.
  • original=true returnerar den första rapporterade versionen av varje period.
  • history=true returnerar varje version av varje period, äldsta först.
  • GET /v1/changes?since=<timestamp> listar fakta som har tillkommit sedan dess.

Endpoints

EndpointVad den ger tillbaka
GET /v1/companiesFöretagskatalog med filter och sidindelning
GET /v1/company/profileProfil, listningar och tillgängliga datamängder
GET /v1/company/metricsKonceptraderna i företagets mall
GET /v1/company/financials/{statement}/standardizedEn standardiserad rapport
GET /v1/company/financials/{statement}/as_reportedInlämnarens egna radposter med taggar
GET /v1/company/ratiosNyckeltal beräknade från rapporterna, med bevis för deras indata
GET /v1/company/ratios/daily/{ratio_id}Ett nyckeltal som en serie över perioder
GET /v1/company/filingsEtt företags index över inlämningar till SEC (inlämnade dokument)
GET /v1/filing/{accession}En inlämning till SEC (inlämnat dokument)
GET /v1/filing/{accession}/factsVarje mappat faktum som en inlämning till SEC (inlämnat dokument) taggade
GET /v1/filing/{accession}/documentLänkar till ett dokuments sidor på EDGAR, eller dess huvuddokument som HTML, PDF eller sidbilder
GET /v1/company/ownership/insidersInsidertransaktioner från Form 3, Form 4 och Form 5
GET /v1/company/ownership/institutionalForm 13F-innehavare i ett bolag, per kvartal
GET /v1/ownership/institutional/holdersForm 13F-förvaltare
GET /v1/ownership/institutional/holdingsEn förvaltares 13F-portfölj för ett kvartal
GET /v1/company/splitsAktiesplitsningar enligt inlämnade uppgifter och om priserna bekräftar dem
GET /v1/company/dividendsUtdelning per aktie som deklarerats eller betalats i varje period, enligt inlämnade uppgifter
GET /v1/events_calendarResultatmeddelanden (8-K Item 2.02 inlämnad) och modellförväntade datum
GET /v1/company/events8-K-poster: ett händelseflöde baserat på inlämningar till SEC (inlämnade dokument)
GET /v1/news8-K-inlämningar för alla bolag som täcks, nyaste först, med händelsetyper och en viktighetsnivå
GET /v1/news/feedFinancialMD:s eget händelseflöde från alla SEC-formulär som innehåller händelser, med regelbaserade rubriker, viktighet och nyckelsiffror. Inte nyhetsbyråmaterial
GET /v1/news/issuer_releasesMeddelanden som emittenter publicerat om sig själva: bilagor till SEC-inlämningar, samt rubrik och länk från emittentens eget flöde
GET /v1/company/call_materialsMaterial om earnings calls som emittenten lämnade in till SEC: pressmeddelanden, förberedda kommentarer, brev, presentationer och ett transkript när ett sådant lämnades in
GET /v1/call_material/{id}Ett dokument som emittenten lämnat in, uppdelat i passager med sektioner, talarbyten och ämnestaggar
GET /v1/calls_calendarEarnings calls som emittenter tillkännager i SEC-inlämningar, med en länk till emittentens egen webbsändningssida
GET /v1/search/filingsFulltextsökning i EDGAR-dokument sedan 2001 (SEC EDGAR fulltextsökning)
GET /v1/coverageVarje datamängd med dess status: tillgänglig, inte täckt (licensierad) eller inte byggd, och vad som ska användas i stället
GET /v1/company/estimatesFinancialMD:s egna modellbaserade grundestimat med intervall och en historik vid en given tidpunkt (point-in-time), företagets guidning så som den anges i dess inlämningar till SEC (inlämnade dokument), och beskrivande signaler. Inte konsensus, inte analytikerestimat. Se metoden
GET /v1/company/estimates/consensusInte täckt: konsensusestimat är licensierade. Svarar 404 not_covered med alternativ
GET /v1/company/analyst_ratingsInte täckt: analytikerbetyg är licensierade. Svarar 404 not_covered
GET /v1/company/transcriptsInte täckt: samtalstranskript är licensierade. Svarar 404 not_covered
GET /v1/company/stock_prices/intradayIngår inte: realtids- och intradagspriser är licensierade. Svarar 404 not_covered
GET /v1/company/logoEn logotyp för att identifiera företaget: en öppet licensierad fil med attribuering, eller en genererad ruta. JSON, SVG eller PNG
GET /v1/politician_tradesAffärer som medlemmar i USA:s representanthus rapporterat i periodiska transaktionsrapporter, som inlämnade, med den officiella rapporten. Aldrig prissatta. Användningen är begränsad av 5 U.S.C. 13107(c)(1): läs data.notice
GET /v1/company/segmentsSegmentfakta som rapporterats som de är (verksamhet, geografi, produkt)
GET /v1/company/ownership/insider_holdersVad varje insider ägde efter sin senaste Form 4 eller 5
GET /v1/company/ownership/fundsFonder som äger företaget i sin senaste N-PORT
GET /v1/fundsN-PORT-fonder med sin senaste rapport
GET /v1/fund/holdingsEn fonds N-PORT-innehav
GET /v1/company/kpisFöretagsrapporterade justerade och operativa mått, vart och ett med sin källa
GET /v1/company/dividend_eventsKontantutdelningar med sina datum som inlämnade
GET /v1/company/ownership/insider_holdingsInnehavsrader från Form 3, 4 och 5
GET /v1/fund/profileEn fonds typ från N-CEN och dess aktieklassers avgifter
GET /v1/fund/navEn fonds nettotillgångar per rapportmånad, varje klasss rapporterade månadsavkastning med vårt avkastningsindex, och closed-end NAV per aktie, från inlämningar till SEC (inlämnade dokument). Daglig NAV tillhandahålls inte
GET /v1/identifiers/xrefGivet en identifierare, företaget eller fonden den avser och de andra öppna identifierarna, vart och ett med sin källa
GET /v1/identifiers/masterÖppna identifierare för varje företag, sidindelat
GET /v1/company/stock_prices/returnsPrisavkastning, totalavkastning och maximal nedgång över standardfönster, beräknade från slutkurser och SEC-inlämnade splitar och utdelningar
GET /v1/company/identifiersLEI och FIGI med sina belägg
GET /v1/company/stock_pricesDagliga barer byggda enbart från affärer på IEX. Inte den konsoliderade tapen. Rådata som standard; adjust=splits eller adjust=total_return lägger till justerade värden
GET /v1/screenScreena alla täckta företag på mått för senaste perioden
POST /v1/verifyKontrollera ett nummer mot det inlämnade värdet
GET /v1/changesFakta som blev kända sedan en viss tidpunkt
POST /v1/request-dataBerätta vilken data du behövde men inte hittade. Ingen nyckel, aldrig debiterad, granskas varje vecka. Se hur du begär
GET /v1/request-dataBody för POST /v1/request-data tar
GET /v1/request-data/{id}Status för en begäran: ny, triagerad, planerad, klar eller wontfix
GET /v1/requestedBegärt och levererat: granskade förfrågningar med antal, inga uppgifter om inskickare
GET /proof/{id}Beviset för ett tillhandahållet värde
GET /v1/company/line_itemsEn rapporterad rad per etikett och period: rapporterade detaljrader, segmentfigurer, företagsmått och vägledning
GET /v1/screen/nlEn enkel screen: frågan tolkas till screen-filter (av en AI-modell eller av fasta regler, märkta) och körs som GET /v1/screen
GET /v1/askEtt AI-skrivet svar om ett företag utifrån dess egna inlämnade värden, där varje siffra kontrolleras mot de angivna fakta
GET /v1/news/summaryEn AI-skriven sammanfattning av en dags nyheter baserade på inlämningar till SEC (inlämnade dokument), eller av ett företags senaste händelser, från FinancialMD:s eget händelseflöde; varje punkt hänvisar till sina inlämningar och varje siffra kontrolleras mot dem
GET /v1/company/ratios/forwardFramåtriktade värderingskvoter på våra egna modellbaserade uppskattningar (märkta modellresultat, aldrig konsensus), med uppskattningen, dess intervall och dess historik
GET /v1/company/technicalsTekniska indikatorer (glidande medelvärden, RSI, MACD, Bollingerband, ATR, stängningsintervall) beräknade från dagliga barer från en enskild handelsplats och SEC-inlämnade splitar
GET /v1/pre_ipoFöretag som har ansökt om börsnotering: registranter med en S-1 eller F-1 inlämnad före någon periodisk rapport, med status, föreslagen ticker och datum
GET /v1/pre_ipo/{cik}En pre-IPO-registrant: status och dess regel, registreringsinlämningar, de finansiella siffror den taggade och erbjudandets villkor lästa från prospektet
GET /v1/fx_ratesDagliga referensväxelkurser från Europeiska centralbankens offentliga filer, valfri tillgänglig valuta mot en annan via euron; referenskurser, inte handlingsbara kurser
GET /v1/researchOberoende forskningsrapporter licensierade under CC BY 4.0, även läsbara utan kostnad på utgivarens webbplats: sök efter företag, samling, språk, ord och datum, var och en med en sammanfattning i rapportens egna ord
GET /v1/research/{id}En forskningsrapport i sin helhet som strukturerad Markdown: avsnitt, tickers, datum, källor, licens och attribueringen som ska behållas vid citering
POST /v1/feedbackBerätta vad som fungerade och vad som inte gjorde det: en kommentar, ett betyg eller skäl. Ingen nyckel, kostar aldrig. GET /v1/feedback beskriver innehållet
POST /v1/data-errorsRapportera en siffra som du tror är fel. Den jämförs direkt med det vi levererar och dagligen med inlämningen till SEC (inlämnat dokument). Följ upp med GET /v1/data-errors/{id}

Det OpenAPI dokumentet har varje parameter och responsschema. llms.txt, llms-full.txt och färdighetsfilen samma sak för agenter; https://api.financial.md/docs är den interaktiva referensen och https://api.financial.md/changelog listar ändringar.

Kontrollera en siffra

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}'

Svaret har en verdict på matches, differs eller unknown, det inlämnade värdet med dess bevis, skillnaden och en scale_hint när ditt tal är fel med en tiopotens.

Gränser

Anrop utan nyckel är begränsade per IP-adress, per dag.

  • 10 mätade anrop: nyckeltal, screen, verify och varje prissatt route, till exempel standardiserade finansiella rapporter, segment och KPI:er
  • 1,000 läsningar på inlämningsnivå: fakta som rapporterats, inlämningar, ägande och priser
  • 1 000 metadataläsningar: katalog, profiler, mätvärden, bevis och ändringar

Varje svar innehåller RateLimit-Limit, RateLimit-Remaining och RateLimit-Reset. En 429 innehåller Retry-After.

Anrop till api.financial.md utan nyckel debiteras aldrig. API-nycklar ingår i planerna Terminal + Agent; se API-nycklar. Agenter kan också betala per anrop på agent.financial.md. Se Prissättning.

Vad som täcks

Täckningen omfattar företag som lämnar in till SEC och är noterade på en amerikansk börs idag.

  • Standardiserade finansiella rapporter finns för deklaranter som rapporterar enligt US GAAP.
  • Deklaranter som rapporterar enligt IFRS, såsom många utländska företag som lämnar in Form 20-F eller 40-F, har inlämningar men ännu inga standardiserade finansiella rapporter.
  • Företag som har avnoterats finns i katalogen med sina finansiella rapporter och inlämningar. Sök upp dem med CIK: de har ingen tickeruppslagning och inga priser, så prishistoriken täcker endast företag som är noterade idag.
  • Ägardata kommer från inlämningar gjorda sedan 1 juli 2026 och uppdateras varje dag kl. 13:00 UTC från EDGAR:s dagliga index: insidertransaktioner från Form 3, Form 4 och Form 5 för täckta företag, samt varje Form 13F-HR, så att ett nytt kvartals 13F-rapporter kommer in när förvaltare lämnar in dem. En 13F-position kopplas till ett företag endast när ett Schedule 13D eller 13G-omslag namnger dess värdepapper. För kvartalet som slutade den 30 juni 2026 kopplar detta 80 procent av det rapporterade värdet; övriga positioner visas i en förvaltares portfölj under emittentens namn som det lämnats in.
  • Konsensusestimat och transkript från earnings calls tillhandahålls inte: båda är licensierad data. Segment tillhandahålls som rapporterade, och nyheter är flödet av 8-K-inlämningar.

När ett företag är känt men en datamängd saknas svarar API not_covered och listar de dataset det har.

MCP-server

MCP-servern omsluter samma API i 57 skrivskyddade verktyg. Den talar MCP Streamable HTTP och kräver inget konto.

https://mcp.financial.md/mcp

MCP-guiden listar verktygen. Serverkortet är för register.

Fel

Ett fel är { "error": { code, message, docs, request_id, remedies } }. Listan remedies säger vad du ska göra härnäst. Felreferensen förklarar varje kod.