[ blog · comparison ]9 min read

API de fondamentaux d'entreprise : bilan, flux de trésorerie et transactions d'initiés pour agents finance

Sarah ChoyPublié le 16 juin 20269 min de lecture

Les cours vous disent ce que le marché pense ; les fondamentaux vous disent s'il a raison. Voici une API de fondamentaux mise en forme pour les agents IA — états financiers, dividendes et transactions d'initiés dans un seul endpoint — et comment elle se compare à SEC EDGAR brut et aux fournisseurs d'API d'états financiers.

L'essentiel

•Fondamentaux = la couche « l'entreprise est-elle réellement saine » : bilan, compte de résultat, flux de trésorerie, dividendes, transactions d'initiés.
•Vous pouvez les parser gratuitement depuis SEC EDGAR (XBRL), mais normaliser le XBRL à travers les déposants et les périodes représente un vrai travail d'ingénierie continu — et c'est limité aux États-Unis et rythmé par les filings, pas mis en forme pour la requête.
•Financials Search d'API Pick renvoie les cinq fondamentaux des sociétés américaines derrière un seul endpoint POST — 200 crédits/appel, au succès uniquement — pré-formatés pour le raisonnement des LLM.
•Les transactions d'initiés (Form 4) et l'historique des dividendes sont les signaux sous-exploités : bon marché à récupérer ici, pénibles à assembler depuis EDGAR.
•Couplez Financials avec SEC Filings (texte qualitatif des 10-K/10-Q) et Markets (cours) pour une vue ancrée complète.

Le cours est une opinion ; les fondamentaux sont des preuves

Un appel de données de marché dit à votre agent combien coûte une action. Il ne peut pas vous dire si l'entreprise derrière elle croît, croule sous la dette ou est discrètement vendue par ses propres dirigeants. C'est la couche des fondamentaux — et c'est là qu'un agent de recherche passe de "cite des cours" à "se forge une opinion."

Cinq jeux de données portent l'essentiel du signal : le bilan, le compte de résultat, le tableau de flux de trésorerie, l'historique des dividendes et les transactions d'initiés.

La taxe EDGAR

Tout cela est public et gratuit dans SEC EDGAR. Le piège, c'est le XBRL. Le JSON company-facts est énorme et incohérent : le même concept est tagué différemment d'un déposant à l'autre, les retraitements brouillent l'historique, et vous devez mapper une taxonomie tentaculaire vers un schéma propre avant que quoi que ce soit en aval puisse l'utiliser. Les données d'initiés (Form 4) et les dividendes sont des types de filings distincts que vous parsez à part. Le faire une fois pour un ticker, c'est un week-end ; le faire de façon fiable pour un agent qui interroge n'importe quelle société, c'est un pipeline à maintenir.

Les fondamentaux comme un seul outil

Financials Search renvoie bilans, comptes de résultat, flux de trésorerie, dividendes et transactions d'initiés pour les sociétés cotées américaines derrière un seul endpoint POST — 200 crédits par appel, au succès uniquement, pré-formatés pour un LLM.

import httpx, os
API, HEADERS = "https://api.apipick.com/v1", {"x-api-key": os.environ["APIPICK_KEY"]}

def fundamentals(query: str):
    return httpx.post(f"{API}/search/financials", headers=HEADERS,
                      json={"query": query}).json()["results"]

fundamentals("Apple latest balance sheet and cash flow")
fundamentals("recent insider transactions at Meta")
fundamentals("Microsoft revenue and net income trend")

EDGAR vs. fournisseur vs. suite

	Parser SEC EDGAR	Fournisseur d'API d'états	API Pick Financials
Coût	Gratuit + ingénierie	Abonnement	200 crédits/appel, au succès uniquement
Mise en place	Pipeline de normalisation XBRL	Intégrer des endpoints typés	Un endpoint, un format
Couverture	US, organisé par filing	Profonde, long historique	Fondamentaux US + initiés + dividendes
Style de requête	Par filing/concept	Paramètres typés	Langage naturel
Idéal pour	Ponctuel / contrôle total	Les fondamentaux comme produit	Agents finance (un outil parmi d'autres)

L'image complète

Les fondamentaux se marient naturellement avec SEC Filings Search pour le versant qualitatif (facteurs de risque, MD&A, langage des earnings calls) et Markets Search pour le cours. Ensemble, ils forment la colonne vertébrale de l'agent de recherche d'investissement. Une seule clé, du JSON de bout en bout, au succès uniquement. Commencez gratuitement avec 100 crédits, sans carte.

Questions fréquentes

Ne puis-je pas simplement obtenir les fondamentaux gratuitement depuis SEC EDGAR ?

Vous le pouvez — les données company-facts et XBRL d'EDGAR sont gratuites et font autorité. Le coût, c'est l'ingénierie : les tags XBRL dérivent d'un déposant et d'une période à l'autre, les retraitements compliquent l'historique, et vous devez mapper des milliers de concepts de taxonomie vers un schéma propre avant qu'un modèle (ou un graphique) puisse les utiliser. C'est aussi limité aux États-Unis et organisé par filing, pas par question. Pour une seule société de temps en temps, EDGAR convient. Pour un agent interrogeant de nombreuses sociétés en langage naturel, une API normalisée fait gagner des semaines.

Qu'est-ce qui est couvert — et est-ce limité aux États-Unis ?

Bilans, comptes de résultat, tableaux de flux de trésorerie, historique des dividendes et transactions d'initiés pour les sociétés cotées américaines. Ce sont des fondamentaux américains ; pour les émetteurs hors États-Unis, vous utiliseriez une source différente. Pour le texte des filings lui-même (facteurs de risque des 10-K, MD&A des 10-Q, earnings calls), utilisez l'endpoint distinct SEC Filings Search.

Pourquoi mettre en avant les transactions d'initiés et les dividendes ?

Ils ont un fort signal et sont pénibles à assembler soi-même. Les achats/ventes d'initiés (SEC Form 4) sont un signal comportemental surveillé ; l'historique des dividendes compte pour les screens de revenu et de qualité. Les deux exigent de parser des types de filings spécifiques depuis EDGAR. Ici, ce sont des champs de premier ordre dans le même endpoint que les états financiers.

Comment cela se compare-t-il aux fournisseurs d'API d'états financiers ?

Les fournisseurs dédiés (par ex. les API d'états financiers) offrent des endpoints typés et profonds et un long historique — parfait si les fondamentaux sont tout votre produit. L'angle d'API Pick est différent : les fondamentaux comme un outil parmi une suite (marchés, SEC, économique, actualités) derrière une seule clé, mis en forme pour la requête d'un agent, facturés au succès uniquement. Si vous construisez un agent finance plutôt qu'un produit de fondamentaux, la suite-dans-un-seul-format est la voie la plus rapide.

Est-ce du conseil en investissement ?

Non. Ce sont des données financières publiques structurées pour la recherche et l'ancrage d'agents. Elles informent l'analyse d'une personne qualifiée ou d'un agent supervisé ; ce n'est pas du conseil et cela ne doit pas piloter de trading automatisé sans responsabilité humaine et contrôles de risque.