Documentation API et MCP
FinancialMD fournit des états financiers établis à partir de dépôts auprès de la SEC (documents déposés). Chaque chiffre renvoie au dépôt auprès de la SEC (document déposé) dont il provient, et chaque chiffre peut être consulté tel qu'il était connu à n'importe quelle date. Aucun compte n'est nécessaire.
Effectuer un premier appel
L'API utilise JSON sur HTTPS. Cet appel renvoie les cinq derniers comptes de résultat annuels d'Apple. Aucune clé n'est nécessaire.
curl "https://api.financial.md/v1/company/financials/income_statement/standardized?company=ticker:AAPL&period_type=annual&limit=5"L'état financier est l'un des suivants : income_statement, balance_sheet, cash_flow ou supplemental. Le type de période est l'un des suivants : annual, quarterly, ltm ou ytd.
Identifier une entreprise
Chaque route d'entreprise accepte un paramètre company.
ticker:AAPL, outicker:AAPL.XNASpour préciser la place boursièrecik:320193, le numéro de l'entreprise auprès de la SECfmd_<id>, l'identifiant attribué à l'entreprise par FinancialMD
AAPL seul est interprété comme un symbole boursier et des chiffres seuls comme un CIK. La réponse indique le critère de correspondance dans meta.company.matched_by.
Lire une valeur
Une réponse réussie est de la forme { data, meta }. Un nombre dans data n'est jamais fourni seul. Il s'agit d'un objet valeur :
{
"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 est l'intervalle de temps pendant lequel ce chiffre était le dernier déposé. restated vaut vrai uniquement lorsqu'un dépôt auprès de la SEC (document déposé) ultérieur a modifié le chiffre ; restatement_kind indique alors de quelle manière. proof.id permet d'accéder, via GET /proof/{id}, au dépôt auprès de la SEC (document déposé) et aux faits bruts à l'origine de la valeur.
Lire le passé tel qu'il était connu
as_of=2024-06-30sur n'importe quelle route de lecture renvoie ce qui était connu à cet instant.original=truerenvoie la première version publiée de chaque période.history=truerenvoie toutes les versions de chaque période, de la plus ancienne à la plus récente.GET /v1/changes?since=<timestamp>liste les faits connus depuis cet instant.
Routes
| Route | Ce qu'elle renvoie |
|---|---|
GET /v1/companies | Annuaire des entreprises avec filtres et pagination |
GET /v1/company/profile | Profil, cotations et jeux de données disponibles |
GET /v1/company/metrics | Les lignes de concepts du modèle de l'entreprise |
GET /v1/company/financials/{statement}/standardized | Un état financier standardisé |
GET /v1/company/financials/{statement}/as_reported | Les postes propres au déposant, avec leurs balises |
GET /v1/company/ratios | Ratios calculés à partir des états financiers, avec les preuves de leurs données d'entrée |
GET /v1/company/ratios/daily/{ratio_id} | Un ratio sous forme de série par période |
GET /v1/company/filings | Index des dépôts auprès de la SEC (documents déposés) d'une société |
GET /v1/filing/{accession} | Un dépôt auprès de la SEC (document déposé) |
GET /v1/filing/{accession}/facts | Toutes les données balisées d'un dépôt auprès de la SEC (document déposé) ayant fait l'objet d'une correspondance |
GET /v1/filing/{accession}/document | Liens vers les pages d'un dépôt auprès de la SEC (document déposé) sur EDGAR, ou vers son document principal au format HTML, PDF ou sous forme d'images de pages |
GET /v1/filing/{accession}/summary | Résumé d'un dépôt auprès de la SEC (document déposé) rédigé par l'IA, avec une source citée pour chaque affirmation ; signalé comme une sortie de modèle |
GET /v1/company/research | Rapport sur une société rédigé par l'IA, chaque chiffre étant vérifié par rapport aux données ; ne constitue pas un conseil |
GET /v1/company/bull_bear | Scénarios haussier et baissier pour une société rédigés par l'IA, avec les mêmes vérifications et citations ; ne constituent pas un conseil |
GET /v1/company/ownership/insiders | Transactions d'initiés issues des formulaires Form 3, Form 4 et Form 5 |
GET /v1/company/ownership/institutional | Détenteurs de titres d'une société déclarés dans le Form 13F, par trimestre |
GET /v1/ownership/institutional/holders | Gestionnaires déclarant un Form 13F |
GET /v1/ownership/institutional/holdings | Portefeuille 13F d'un gestionnaire pour un trimestre |
GET /v1/company/splits | Divisions d'actions telles que déclarées, avec indication de leur confirmation par les cours |
GET /v1/company/dividends | Dividendes par action déclarés ou versés au cours de chaque période, tels que déclarés dans les documents déposés |
GET /v1/events_calendar | Communiqués de résultats (8-K Item 2.02 déposé) et dates prévues par le modèle |
GET /v1/company/events | Rubriques 8-K : un flux d'événements fondé sur les dépôts auprès de la SEC (documents déposés) |
GET /v1/news | Dépôts auprès de la SEC (documents déposés) 8-K de toutes les sociétés couvertes, du plus récent au plus ancien, avec types d'événements et niveau d'importance |
GET /v1/news/feed | Flux d'événements propre à FinancialMD, issu de tous les formulaires SEC contenant des événements, avec titres générés par des règles, niveau d'importance et chiffres clés. Ce ne sont pas des dépêches d'agence |
GET /v1/news/issuer_releases | Communiqués publiés par les émetteurs à leur propre sujet : pièces jointes SEC, ainsi que titre et lien issus du flux de l'émetteur |
GET /v1/company/call_materials | Documents relatifs aux conférences de présentation des résultats déposés par l'émetteur auprès de la SEC : communiqués, interventions préparées, lettres, présentations et transcription lorsqu'il en a déposé une |
GET /v1/call_material/{id} | Un document déposé par l'émetteur, découpé en passages avec sections, tours de parole et étiquettes thématiques |
GET /v1/calls_calendar | Conférences de présentation des résultats telles qu'annoncées par les émetteurs dans leurs dépôts auprès de la SEC (documents déposés), avec un lien vers la page de retransmission de l'émetteur |
GET /v1/search/filings | Recherche en texte intégral dans les documents EDGAR depuis 2001 (recherche en texte intégral SEC EDGAR) |
GET /v1/coverage | Tous les jeux de données avec leur statut : disponible, non couvert (sous licence) ou non développé, et les solutions de remplacement |
GET /v1/company/estimates | Estimations de référence propres à FinancialMD, fondées sur un modèle, avec intervalles et historique à date (point-in-time), prévisions de la société telles qu'énoncées dans ses dépôts auprès de la SEC (documents déposés), et signaux descriptifs. Ni consensus, ni estimations d'analystes. Voir la méthode |
GET /v1/company/estimates/consensus | Non couvert : les estimations de consensus sont sous licence. Renvoie 404 not_covered avec des solutions de remplacement |
GET /v1/company/analyst_ratings | Non couvert : les recommandations d'analystes sont sous licence. Renvoie 404 not_covered |
GET /v1/company/transcripts | Non couvert : les transcriptions de conférences sont sous licence. Renvoie 404 not_covered |
GET /v1/company/stock_prices/intraday | Non couvert : les cours en temps réel et intrajournaliers sont sous licence. Renvoie 404 not_covered |
GET /v1/company/logo | Un logo pour identifier la société : un fichier sous licence ouverte avec son attribution, ou une vignette générée. JSON, SVG ou PNG |
GET /v1/politician_trades | Transactions déclarées par les membres de la Chambre des représentants des États-Unis dans les rapports périodiques de transactions, telles que déposées, avec le rapport officiel. Jamais facturées. L'utilisation est limitée par 5 U.S.C. 13107(c)(1) : lire data.notice |
GET /v1/fund_letters | Index des lettres de fonds et des analyses de performance figurant dans les dépôts auprès de la SEC (documents déposés) N-CSR, avec les sociétés qui y sont nommées. Fournit un lien vers l'original ; n'héberge aucun texte de lettre |
GET /v1/fund_letters/sources | Sources de l'index des lettres de fonds, sites des gestionnaires répertoriés avec leurs conditions d'utilisation, et décomptes |
GET /v1/fund_letters/{id} | Une lettre de fonds indexée avec toutes les sociétés qu'elle nomme |
GET /v1/company/segments | Données sectorielles telles que publiées (activité, zone géographique, produit) |
GET /v1/company/ownership/insider_holders | Titres détenus par chaque initié après son dernier Form 4 ou Form 5 |
GET /v1/company/ownership/funds | Fonds détenant des titres de la société dans leur dernier Form N-PORT |
GET /v1/funds | Fonds déclarant un Form N-PORT avec leur dernier rapport |
GET /v1/fund/holdings | Positions d'un fonds déclarées dans le Form N-PORT |
GET /v1/company/kpis | Indicateurs ajustés et opérationnels publiés par l'entreprise, chacun avec sa référence |
GET /v1/company/dividend_events | Dividendes en numéraire avec leurs dates telles que déposées |
GET /v1/company/ownership/insider_holdings | Lignes de positions des formulaires Form 3, Form 4 et Form 5 |
GET /v1/fund/profile | Type d'un fonds selon N-CEN et frais de ses catégories de parts |
GET /v1/fund/nav | Actif net d'un fonds par mois de rapport, rendement mensuel publié de chaque catégorie avec notre indice de rendement, et valeur liquidative par part des fonds fermés, issus des dépôts auprès de la SEC (documents déposés). La valeur liquidative quotidienne n'est pas fournie |
GET /v1/identifiers/xref | À partir d'un identifiant, l'entreprise ou le fonds qu'il désigne et les autres identifiants ouverts, chacun avec sa source |
GET /v1/identifiers/master | Identifiants ouverts de chaque entreprise, avec pagination |
GET /v1/company/stock_prices/returns | Rendement du cours, rendement total et baisse maximale sur des périodes standard, calculés à partir des barres de fin de journée et des divisions d'actions et dividendes déposés auprès de la SEC |
GET /v1/company/identifiers | LEI et FIGI avec leurs éléments justificatifs |
GET /v1/company/stock_prices | Barres quotidiennes construites uniquement à partir des transactions sur IEX. Il ne s'agit pas du flux consolidé. Données brutes par défaut ; adjust=splits ou adjust=total_return ajoute des valeurs ajustées |
GET /v1/screen | Filtrer toutes les entreprises couvertes selon les indicateurs de la dernière période |
POST /v1/verify | Vérifier un chiffre par rapport à la valeur déposée |
GET /v1/changes | Données devenues connues depuis un instant donné |
POST /v1/request-data | Dites-nous quelles données vous cherchiez et n'avez pas trouvées. Sans clé, jamais facturé, examiné chaque semaine. Voir comment faire une demande |
GET /v1/request-data | Le corps accepté par POST /v1/request-data |
GET /v1/request-data/{id} | Le statut d'une demande : new, triaged, planned, done ou wontfix |
GET /v1/requested | Demandées et livrées : demandes examinées avec décomptes, sans détails sur leurs auteurs |
GET /proof/{id} | La preuve d'une valeur fournie |
Le document OpenAPI contient tous les paramètres et schémas de réponse. Les fichiers llms.txt, llms-full.txt et le fichier de compétences fournissent les mêmes informations aux agents ; https://api.financial.md/docs est la référence interactive et https://api.financial.md/changelog répertorie les modifications.
Vérifier un chiffre
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}'La réponse contient un verdict de matches, differs ou unknown, la valeur déposée avec sa preuve, l'écart, et un scale_hint lorsque votre chiffre diffère d'une puissance de dix.
Limites
Les appels sans clé sont limités par adresse IP et par jour.
- 25 appels comptabilisés : ratios, filtrage et vérification
- 1,000 lectures de la couche des dépôts auprès de la SEC (documents déposés) : états financiers, données telles que publiées, dépôts auprès de la SEC (documents déposés), détention de titres et cours
- 1,000 lectures de métadonnées : annuaire, profils, indicateurs, preuves et modifications
Chaque réponse contient RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset. Une réponse 429 contient Retry-After.
Les clés API offrant des limites plus élevées ne sont pas encore délivrées. Voir Clés API. Les appels sur api.financial.md sont gratuits. Les agents peuvent payer par appel sur agent.financial.md. Voir Tarifs.
Périmètre couvert
La couverture comprend les entreprises qui déposent des documents auprès de la SEC et sont aujourd'hui cotées sur une bourse américaine.
- Des états financiers standardisés sont disponibles pour les déclarants qui publient selon les US GAAP.
- Les déclarants qui publient selon les IFRS, comme de nombreuses entreprises étrangères qui déposent un Form 20-F ou 40-F, disposent de dépôts auprès de la SEC (documents déposés), mais pas encore d'états financiers standardisés.
- Les entreprises radiées de la cote figurent dans l'annuaire avec leurs états financiers et leurs dépôts auprès de la SEC (documents déposés). Recherchez-les par CIK : elles ne sont pas accessibles par recherche de symbole boursier et n'ont pas de cours ; l'historique des cours ne couvre donc que les entreprises cotées aujourd'hui.
- Les données de détention de titres proviennent des dépôts auprès de la SEC (documents déposés) effectués depuis July 1, 2026 et sont mises à jour chaque jour à 13:00 UTC à partir de l'index quotidien EDGAR : transactions d'initiés issues des formulaires Form 3, Form 4 et Form 5 des entreprises couvertes, et chaque Form 13F-HR ; les rapports 13F d'un nouveau trimestre arrivent donc à mesure que les gestionnaires les déposent. Une position 13F n'est rattachée à une entreprise que lorsque la page de couverture d'un Schedule 13D ou 13G désigne son titre. Pour le trimestre clos le June 30, 2026, cela rattache 80 pour cent de la valeur publiée ; les autres positions apparaissent dans le portefeuille du gestionnaire sous le nom de l'émetteur tel que déposé.
- Les estimations du consensus et les transcriptions des conférences de résultats ne sont pas fournies : toutes deux sont des données sous licence. Les données sectorielles sont fournies telles que publiées, et les actualités correspondent au flux des dépôts auprès de la SEC (documents déposés) 8-K.
Lorsqu'une entreprise est connue mais qu'un jeu de données manque, l'API répond not_covered et répertorie les jeux de données dont elle dispose.
Serveur MCP
Le serveur MCP expose la même API sous la forme de 50 outils en lecture seule. Il utilise MCP Streamable HTTP et ne nécessite aucun compte.
https://mcp.financial.md/mcpLe guide MCP répertorie les outils. La fiche du serveur est destinée aux registres.
Erreurs
Une erreur prend la forme { "error": { code, message, docs, request_id, remedies } }. La liste remedies indique la marche à suivre. La référence des erreurs explique chaque code.