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, ellerticker:AAPL.XNASför att namnge börsencik:320193, SECföretagsnummerfmd_<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-30på vilken läsrutt som helst returnerar det som var känt vid det tillfället.original=truereturnerar den första rapporterade versionen av varje period.history=truereturnerar varje version av varje period, äldsta först.GET /v1/changes?since=<timestamp>listar fakta som har tillkommit sedan dess.
Endpoints
| Endpoint | Vad den ger tillbaka |
|---|---|
GET /v1/companies | Företagskatalog med filter och sidindelning |
GET /v1/company/profile | Profil, listningar och tillgängliga datamängder |
GET /v1/company/metrics | Konceptraderna i företagets mall |
GET /v1/company/financials/{statement}/standardized | En standardiserad rapport |
GET /v1/company/financials/{statement}/as_reported | Inlämnarens egna radposter med taggar |
GET /v1/company/ratios | Nyckeltal 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/filings | Ett 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}/facts | Varje mappat faktum som en inlämning till SEC (inlämnat dokument) taggade |
GET /v1/filing/{accession}/document | Länkar till ett dokuments sidor på EDGAR, eller dess huvuddokument som HTML, PDF eller sidbilder |
GET /v1/company/ownership/insiders | Insidertransaktioner från Form 3, Form 4 och Form 5 |
GET /v1/company/ownership/institutional | Form 13F-innehavare i ett bolag, per kvartal |
GET /v1/ownership/institutional/holders | Form 13F-förvaltare |
GET /v1/ownership/institutional/holdings | En förvaltares 13F-portfölj för ett kvartal |
GET /v1/company/splits | Aktiesplitsningar enligt inlämnade uppgifter och om priserna bekräftar dem |
GET /v1/company/dividends | Utdelning per aktie som deklarerats eller betalats i varje period, enligt inlämnade uppgifter |
GET /v1/events_calendar | Resultatmeddelanden (8-K Item 2.02 inlämnad) och modellförväntade datum |
GET /v1/company/events | 8-K-poster: ett händelseflöde baserat på inlämningar till SEC (inlämnade dokument) |
GET /v1/news | 8-K-inlämningar för alla bolag som täcks, nyaste först, med händelsetyper och en viktighetsnivå |
GET /v1/news/feed | FinancialMD: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_releases | Meddelanden 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_materials | Material 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_calendar | Earnings calls som emittenter tillkännager i SEC-inlämningar, med en länk till emittentens egen webbsändningssida |
GET /v1/search/filings | Fulltextsökning i EDGAR-dokument sedan 2001 (SEC EDGAR fulltextsökning) |
GET /v1/coverage | Varje 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/estimates | FinancialMD: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/consensus | Inte täckt: konsensusestimat är licensierade. Svarar 404 not_covered med alternativ |
GET /v1/company/analyst_ratings | Inte täckt: analytikerbetyg är licensierade. Svarar 404 not_covered |
GET /v1/company/transcripts | Inte täckt: samtalstranskript är licensierade. Svarar 404 not_covered |
GET /v1/company/stock_prices/intraday | Ingår inte: realtids- och intradagspriser är licensierade. Svarar 404 not_covered |
GET /v1/company/logo | En logotyp för att identifiera företaget: en öppet licensierad fil med attribuering, eller en genererad ruta. JSON, SVG eller PNG |
GET /v1/politician_trades | Affä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/segments | Segmentfakta som rapporterats som de är (verksamhet, geografi, produkt) |
GET /v1/company/ownership/insider_holders | Vad varje insider ägde efter sin senaste Form 4 eller 5 |
GET /v1/company/ownership/funds | Fonder som äger företaget i sin senaste N-PORT |
GET /v1/funds | N-PORT-fonder med sin senaste rapport |
GET /v1/fund/holdings | En fonds N-PORT-innehav |
GET /v1/company/kpis | Företagsrapporterade justerade och operativa mått, vart och ett med sin källa |
GET /v1/company/dividend_events | Kontantutdelningar med sina datum som inlämnade |
GET /v1/company/ownership/insider_holdings | Innehavsrader från Form 3, 4 och 5 |
GET /v1/fund/profile | En fonds typ från N-CEN och dess aktieklassers avgifter |
GET /v1/fund/nav | En 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/xref | Givet 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/returns | Prisavkastning, totalavkastning och maximal nedgång över standardfönster, beräknade från slutkurser och SEC-inlämnade splitar och utdelningar |
GET /v1/company/identifiers | LEI och FIGI med sina belägg |
GET /v1/company/stock_prices | Dagliga 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/screen | Screena alla täckta företag på mått för senaste perioden |
POST /v1/verify | Kontrollera ett nummer mot det inlämnade värdet |
GET /v1/changes | Fakta som blev kända sedan en viss tidpunkt |
POST /v1/request-data | Berätta vilken data du behövde men inte hittade. Ingen nyckel, aldrig debiterad, granskas varje vecka. Se hur du begär |
GET /v1/request-data | Body 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/requested | Begä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_items | En rapporterad rad per etikett och period: rapporterade detaljrader, segmentfigurer, företagsmått och vägledning |
GET /v1/screen/nl | En 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/ask | Ett 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/summary | En 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/forward | Framåtriktade värderingskvoter på våra egna modellbaserade uppskattningar (märkta modellresultat, aldrig konsensus), med uppskattningen, dess intervall och dess historik |
GET /v1/company/technicals | Tekniska 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_ipo | Fö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_rates | Dagliga referensväxelkurser från Europeiska centralbankens offentliga filer, valfri tillgänglig valuta mot en annan via euron; referenskurser, inte handlingsbara kurser |
GET /v1/research | Oberoende 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/feedback | Berä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-errors | Rapportera 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/mcpMCP-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.