Introduction à l’ingestion des données SEC EDGAR

SEC EDGAR (Electronic Data Gathering, Analysis, and Retrieval) est l’une des sources publiques les plus importantes de données financières pour les sociétés cotées aux États-Unis. Dans le cadre du prototype de connecteur de données publiques, l’ingestion des données provenant de SEC EDGAR permet de récupérer l’historique des dépôts d’entreprise, les rapports annuels 10-K, les rapports trimestriels 10-Q ainsi que les états financiers détaillés en XBRL.

La SEC fournit des API REST publiques et gratuites qui renvoient des données JSON bien structurées sans nécessiter d’authentification ni de clés API.

1. API SEC EDGAR Submissions

Documentation officielle : SEC EDGAR APIs

Description : Cette API renvoie l’historique complet des dépôts d’une entreprise, les informations de base sur la société (nom, ticker, place boursière, code SIC) ainsi que les métadonnées de tous les dépôts effectués, y compris les formulaires 10-K, 10-Q, 8-K et d’autres.

Point de terminaison principal : https://data.sec.gov/submissions/CIK##########.json

Exemple

https://data.sec.gov/submissions/CIK0000320193.json

2. API SEC EDGAR Company Facts

Description : Renvoie toutes les données financières XBRL extraites pour une entreprise en un seul appel API. Il s’agit de l’un des points de terminaison les plus précieux pour l’analyse financière.

Point de terminaison principal : https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json

Exemple

https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json

3. API SEC EDGAR Company Concept

Description : Renvoie l’historique complet en série temporelle d’un concept financier spécifique (par exemple : chiffre d’affaires, bénéfice net, actifs, passifs, trésorerie, etc.).

Point de terminaison principal : https://data.sec.gov/api/xbrl/companyconcept/CIK##########/us-gaap/[Concept].json

Exemple

https://data.sec.gov/api/xbrl/companyconcept/CIK0000320193/us-gaap/Revenues.json

4. API SEC EDGAR Frames et aperçu XBRL

Description : Permet de comparer une métrique financière spécifique entre plusieurs entreprises et différentes périodes (données annuelles, trimestrielles ou instantanées).

Point de terminaison principal : https://data.sec.gov/api/xbrl/frames/us-gaap/[Concept]/[Unit]/[Period].json

Exemple

https://data.sec.gov/api/xbrl/frames/us-gaap/AccountsPayableCurrent/USD/CY2019Q1I.json

Téléchargements de données en masse

Pour le traitement à grande échelle, la SEC fournit des fichiers ZIP mis à jour quotidiennement :

• Company Facts ZIP : companyfacts.zip
• Submissions ZIP : submissions.zip

Bonnes pratiques pour l’ingestion des données SEC EDGAR

• Toujours inclure un en-tête User-Agent descriptif dans les requêtes
• Respecter les limites de débit (maximum de 10 requêtes par seconde)
• Conserver les métadonnées sources (numéro d’accession, date du dépôt, URL, horodatage) pour assurer la traçabilité
• Utiliser les fichiers ZIP en masse pour l’initialisation des données et les processus ETL à grande échelle
• Combiner avec des outils d’analyse pour le traitement des données XBRL

Conclusion

Les API SEC EDGAR Submissions, Company Facts et Company Concept constituent le cœur de l’ingestion des données financières dans le prototype de connecteur de données publiques. L’intégration réussie de ces API permet au prototype de récupérer des informations financières fiables sur les entreprises, l’historique des dépôts et des données XBRL structurées, fournissant ainsi une base solide pour l’analyse des fournisseurs, les calculs de dépendance économique et les outils d’évaluation des risques.