Felo API PlatformFelo API Platform
Tous les endpoints Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Obtenir un instantané des résultats

Serveur:https://openapi.felo.ai
Bibliothèques clientes

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

Financial Data Opérations

Obtenir un instantané des résultats

​

Résultats publiés pour une action, chiffres réels face aux estimations. Chaque entrée comporte report_period, fiscal_period, filing_date, filing_url et accession_number, un bloc quarterly avec revenue, estimated_revenue, revenue_surprise et revenue_surprise_pct, le même trio pour earnings_per_share, ainsi que des champs de variation d'une année sur l'autre. Renvoie aussi signals : des indicateurs calculés en amont, comme EPS_BEAT, avec un headline et les valeurs actual / estimate / surprise_pct qui le sous-tendent. ticker est obligatoire et c'est le seul paramètre. Utilisez-le pour ce qu'une société a réellement publié. Pour le consensus prospectif qui n'a pas encore eu lieu, utilisez get_financial_analyst_estimates.

Référence tarifaire

  • Mesure : base de coût fixe par requête réussie.
  • Estimation de référence par requête : USD 0.02.
  • Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Paramètres de requête
  • cursor
    Type: string

    Curseur de pagination opaque provenant du next_page_url d'une réponse précédente. Lorsqu'il est fourni, tous les autres paramètres de requête sont ignorés : le curseur transporte les filtres de la requête d'origine. Traitez-le comme opaque ; ne le construisez ni ne le modifiez.

  • limit
    Type: integer
    min.:  
    1
    max.:  
    40

    Nombre de périodes de rapport les plus récentes de dépôts à renvoyer, triés par (report_period DESC, filing_date ASC). Le nombre d'entrées renvoyées peut dépasser limit lorsqu'une période récente comporte à la fois un 8-K et un 10-Q / 10-K. Les valeurs supérieures à 40 sont plafonnées à 40. Les valeurs non positives ou non entières renvoient 400. Il s'agit du total sur toutes les pages, et non de la taille d'une page : chaque page contient jusqu'à 10 enregistrements, reliés par next_page_url.

  • ticker
    Type: string
    obligatoire

    Le symbole boursier (par exemple, AAPL).

Réponses
  • 200
    Type: object · ResponseE40Feb4D3D6B_EarningsResponse

    Réponse de résultats

    • earnings
      Type: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]

      Liste à plat des documents SEC du ticker, triée par (report_period DESC, filing_date ASC). Avec limit=N, jusqu'à N report_periods de documents sont renvoyés ; le nombre d'entrées peut dépasser N lorsqu'une période récente comporte à la fois un 8-K et un 10-Q/10-K.

      • accession_number
        Type: string
        obligatoire

        Numéro d'accession SEC identifiant le document.

      • filing_date
        Type: string Format: date
        obligatoire

        Jour calendaire auquel la SEC a accepté le document, heure de l'Est (fuseau horaire de fonctionnement de la SEC). Paire de jour calendaire avec filing_datetime.

      • filing_url
        Type: string Format: uri
        obligatoire

        URL du document SEC.

      • report_period
        Type: string Format: date
        obligatoire

        Période de référence couverte par ce document.

      • source_type
        Type: string enum
        obligatoire

        Le type de formulaire SEC sur lequel repose ce document.

        valeurs
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        Type: string
        obligatoire

        Le symbole ticker demandé.

      • annual
        Type: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          Type: number | null
        • capital_expenditure_chg
          Type: number

          Variation en pourcentage des dépenses d'investissement par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • capital_expenditure_yoy_chg
          Type: number

          Variation interannuelle des dépenses d'investissement par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • cash_and_equivalents
          Type: number | null
        • change_in_cash_and_equivalents
          Type: number | null
        • earnings_per_share
          Type: number | null
        • earnings_per_share_chg
          Type: number

          Variation en pourcentage du BPA par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • earnings_per_share_yoy_chg
          Type: number

          Variation interannuelle du BPA par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • free_cash_flow
          Type: number | null
        • free_cash_flow_chg
          Type: number

          Variation en pourcentage du flux de trésorerie disponible par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • free_cash_flow_yoy_chg
          Type: number

          Variation interannuelle du flux de trésorerie disponible par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • gross_margin
          Type: number

          Marge brute sous forme décimale (gross_profit / revenue). Renvoyée uniquement lorsqu'elle est calculable.

        • gross_margin_chg_bps
          Type: number

          Variation absolue de la marge brute par rapport à la période précédente, en points de base (par exemple 200.0 = marge en hausse de 200 bps). Renvoyée uniquement lorsqu'elle est calculable.

        • gross_margin_chg_pct
          Type: number

          Variation en pourcentage de la marge brute par rapport à la période précédente, sous forme décimale. Renvoyée uniquement lorsqu'elle est calculable.

        • gross_margin_yoy_chg_bps
          Type: number

          Variation interannuelle de la marge brute par rapport au même trimestre fiscal de l'année précédente, en points de base. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • gross_margin_yoy_chg_pct
          Type: number

          Variation interannuelle en pourcentage de la marge brute par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • gross_profit
          Type: number | null
        • gross_profit_chg
          Type: number

          Variation en pourcentage du bénéfice brut par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • gross_profit_yoy_chg
          Type: number

          Variation interannuelle du bénéfice brut par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_financing
          Type: number | null
        • net_cash_flow_from_financing_chg
          Type: number

          Variation en pourcentage du flux de trésorerie net de financement par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_financing_yoy_chg
          Type: number

          Variation interannuelle du flux de trésorerie net de financement par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_investing
          Type: number | null
        • net_cash_flow_from_investing_chg
          Type: number

          Variation en pourcentage du flux de trésorerie net d'investissement par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_investing_yoy_chg
          Type: number

          Variation interannuelle du flux de trésorerie net d'investissement par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_operations
          Type: number | null
        • net_cash_flow_from_operations_chg
          Type: number

          Variation en pourcentage du flux de trésorerie net d'exploitation par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_operations_yoy_chg
          Type: number

          Variation interannuelle du flux de trésorerie net d'exploitation par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_income
          Type: number | null
        • net_income_chg
          Type: number

          Variation en pourcentage du résultat net par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • net_income_yoy_chg
          Type: number

          Variation interannuelle du résultat net par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_margin
          Type: number

          Marge nette sous forme décimale (net_income / revenue). Renvoyée uniquement lorsqu'elle est calculable.

        • net_margin_chg_bps
          Type: number

          Variation absolue de la marge nette par rapport à la période précédente, en points de base. Renvoyée uniquement lorsqu'elle est calculable.

        • net_margin_chg_pct
          Type: number

          Variation en pourcentage de la marge nette par rapport à la période précédente, sous forme décimale. Renvoyée uniquement lorsqu'elle est calculable.

        • net_margin_yoy_chg_bps
          Type: number

          Variation interannuelle de la marge nette par rapport au même trimestre fiscal de l'année précédente, en points de base. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_margin_yoy_chg_pct
          Type: number

          Variation interannuelle en pourcentage de la marge nette par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_income
          Type: number | null
        • operating_income_chg
          Type: number

          Variation en pourcentage du résultat opérationnel par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_income_yoy_chg
          Type: number

          Variation interannuelle du résultat opérationnel par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_margin
          Type: number

          Marge opérationnelle sous forme décimale (operating_income / revenue). Renvoyée uniquement lorsqu'elle est calculable.

        • operating_margin_chg_bps
          Type: number

          Variation absolue de la marge opérationnelle par rapport à la période précédente, en points de base. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_margin_chg_pct
          Type: number

          Variation en pourcentage de la marge opérationnelle par rapport à la période précédente, sous forme décimale. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_margin_yoy_chg_bps
          Type: number

          Variation interannuelle de la marge opérationnelle par rapport au même trimestre fiscal de l'année précédente, en points de base. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_margin_yoy_chg_pct
          Type: number

          Variation interannuelle en pourcentage de la marge opérationnelle par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • revenue
          Type: number | null
        • revenue_chg
          Type: number

          Variation en pourcentage du chiffre d'affaires par rapport à la période précédente, sous forme décimale (par exemple 0.10 = +10%). Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • revenue_yoy_chg
          Type: number

          Variation interannuelle du chiffre d'affaires par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • shareholders_equity
          Type: number | null
        • total_assets
          Type: number | null
        • total_debt
          Type: number | null
        • total_liabilities
          Type: number | null
        • weighted_average_shares
          Type: number | null
        • weighted_average_shares_diluted
          Type: number | null
      • currency
        Type: string

        Code de devise ISO (par exemple USD).

      • filing_datetime
        Type: string | null Format: date-time

        Horodatage à précision infra-journalière enregistrant le moment où la SEC a accepté le document, heure de l'Est. Issu du champ acceptanceDateTime de la SEC dans l'API de soumissions EDGAR. Fait la paire avec filing_date (précision au jour calendaire du même événement).

      • filing_window
        Type: string | null enum

        Séance de marché au moment où la SEC a accepté le document, évaluée à l'heure de l'Est. PRE_MARKET = jour ouvré, 04:00–09:30 ET. DURING_MARKET = jour ouvré, 09:30–16:00 ET. AFTER_HOURS = jour ouvré en dehors des heures de négociation régulières. WEEKEND = samedi ou dimanche. null lorsque filing_datetime n'est pas disponible.

        valeurs
        • PRE_MARKET
        • DURING_MARKET
        • AFTER_HOURS
        • WEEKEND
      • fiscal_period
        Type: string

        Libellé de la période fiscale (par exemple 2026-Q1 ou 2025-FY).

      • quarterly
        Type: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          Type: number | null
        • capital_expenditure_chg
          Type: number

          Variation en pourcentage des dépenses d'investissement par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • capital_expenditure_yoy_chg
          Type: number

          Variation interannuelle des dépenses d'investissement par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • cash_and_equivalents
          Type: number | null
        • change_in_cash_and_equivalents
          Type: number | null
        • earnings_per_share
          Type: number | null
        • earnings_per_share_chg
          Type: number

          Variation en pourcentage du BPA par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • earnings_per_share_yoy_chg
          Type: number

          Variation interannuelle du BPA par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • free_cash_flow
          Type: number | null
        • free_cash_flow_chg
          Type: number

          Variation en pourcentage du flux de trésorerie disponible par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • free_cash_flow_yoy_chg
          Type: number

          Variation interannuelle du flux de trésorerie disponible par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • gross_margin
          Type: number

          Marge brute sous forme décimale (gross_profit / revenue). Renvoyée uniquement lorsqu'elle est calculable.

        • gross_margin_chg_bps
          Type: number

          Variation absolue de la marge brute par rapport à la période précédente, en points de base (par exemple 200.0 = marge en hausse de 200 bps). Renvoyée uniquement lorsqu'elle est calculable.

        • gross_margin_chg_pct
          Type: number

          Variation en pourcentage de la marge brute par rapport à la période précédente, sous forme décimale. Renvoyée uniquement lorsqu'elle est calculable.

        • gross_margin_yoy_chg_bps
          Type: number

          Variation interannuelle de la marge brute par rapport au même trimestre fiscal de l'année précédente, en points de base. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • gross_margin_yoy_chg_pct
          Type: number

          Variation interannuelle en pourcentage de la marge brute par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • gross_profit
          Type: number | null
        • gross_profit_chg
          Type: number

          Variation en pourcentage du bénéfice brut par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • gross_profit_yoy_chg
          Type: number

          Variation interannuelle du bénéfice brut par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_financing
          Type: number | null
        • net_cash_flow_from_financing_chg
          Type: number

          Variation en pourcentage du flux de trésorerie net de financement par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_financing_yoy_chg
          Type: number

          Variation interannuelle du flux de trésorerie net de financement par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_investing
          Type: number | null
        • net_cash_flow_from_investing_chg
          Type: number

          Variation en pourcentage du flux de trésorerie net d'investissement par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_investing_yoy_chg
          Type: number

          Variation interannuelle du flux de trésorerie net d'investissement par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_operations
          Type: number | null
        • net_cash_flow_from_operations_chg
          Type: number

          Variation en pourcentage du flux de trésorerie net d'exploitation par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • net_cash_flow_from_operations_yoy_chg
          Type: number

          Variation interannuelle du flux de trésorerie net d'exploitation par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_income
          Type: number | null
        • net_income_chg
          Type: number

          Variation en pourcentage du résultat net par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • net_income_yoy_chg
          Type: number

          Variation interannuelle du résultat net par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_margin
          Type: number

          Marge nette sous forme décimale (net_income / revenue). Renvoyée uniquement lorsqu'elle est calculable.

        • net_margin_chg_bps
          Type: number

          Variation absolue de la marge nette par rapport à la période précédente, en points de base. Renvoyée uniquement lorsqu'elle est calculable.

        • net_margin_chg_pct
          Type: number

          Variation en pourcentage de la marge nette par rapport à la période précédente, sous forme décimale. Renvoyée uniquement lorsqu'elle est calculable.

        • net_margin_yoy_chg_bps
          Type: number

          Variation interannuelle de la marge nette par rapport au même trimestre fiscal de l'année précédente, en points de base. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • net_margin_yoy_chg_pct
          Type: number

          Variation interannuelle en pourcentage de la marge nette par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_income
          Type: number | null
        • operating_income_chg
          Type: number

          Variation en pourcentage du résultat opérationnel par rapport à la période précédente, sous forme décimale. Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_income_yoy_chg
          Type: number

          Variation interannuelle du résultat opérationnel par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_margin
          Type: number

          Marge opérationnelle sous forme décimale (operating_income / revenue). Renvoyée uniquement lorsqu'elle est calculable.

        • operating_margin_chg_bps
          Type: number

          Variation absolue de la marge opérationnelle par rapport à la période précédente, en points de base. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_margin_chg_pct
          Type: number

          Variation en pourcentage de la marge opérationnelle par rapport à la période précédente, sous forme décimale. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_margin_yoy_chg_bps
          Type: number

          Variation interannuelle de la marge opérationnelle par rapport au même trimestre fiscal de l'année précédente, en points de base. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • operating_margin_yoy_chg_pct
          Type: number

          Variation interannuelle en pourcentage de la marge opérationnelle par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • revenue
          Type: number | null
        • revenue_chg
          Type: number

          Variation en pourcentage du chiffre d'affaires par rapport à la période précédente, sous forme décimale (par exemple 0.10 = +10%). Séquentielle dans la charge utile trimestrielle, interannuelle dans la charge utile annuelle. Renvoyée uniquement lorsqu'elle est calculable.

        • revenue_yoy_chg
          Type: number

          Variation interannuelle du chiffre d'affaires par rapport au même trimestre fiscal de l'année précédente, sous forme décimale. Charge utile trimestrielle uniquement. Renvoyée uniquement lorsqu'elle est calculable.

        • shareholders_equity
          Type: number | null
        • total_assets
          Type: number | null
        • total_debt
          Type: number | null
        • total_liabilities
          Type: number | null
        • weighted_average_shares
          Type: number | null
        • weighted_average_shares_diluted
          Type: number | null
      • signals
        Type: array object[] · ResponseE40Feb4D3D6B_Signal[]

        Informations clés, sélectionnées pour leur impact sur le marché, extraites de ce document. Chaque élément comporte un headline pré-rendu, des details structurés et un classement importance. Renvoyé uniquement lorsqu'au moins un signal se déclenche pour cette entrée ; le champ est omis sinon. Limité à 8 par entrée, classés HIGH → MEDIUM → LOW.

        Une information clé sélectionnée pour son impact sur le marché, dérivée de ce document. Le headline pré-rendu convient à un affichage direct ; details contient des champs structurés pour le filtrage et l'usage programmatique. Les signaux sont renvoyés par ordre de priorité (le plus important en premier) ; le type lui-même encode l'ampleur (par exemple STRONG_REVENUE_INCREASE vs REVENUE_INCREASE).

        • headline
          Type: string
          obligatoire

          Résumé pré-rendu et lisible, adapté à un affichage direct.

        • type
          Type: string enum
          obligatoire

          Catégorie de signal. MARGIN_EXPANSION/MARGIN_CONTRACTION : l'une des marges brute, opérationnelle ou nette a évolué sur un an de ≥100 bps. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED : changement de guidance prospective déclaré dans le document. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE : segment à présenter le plus ou le moins performant selon la croissance organique du chiffre d'affaires. NON_GAAP_DIVERGENCE : un chiffre ajusté/non-GAAP diffère sensiblement de son équivalent GAAP sur la même période. BACKLOG_SURGE/BACKLOG_DECLINE : le carnet de commandes ou les obligations de performance restantes a évolué sur un an de ≥20 %. REVENUE_INCREASE/STRONG_REVENUE_INCREASE et variantes DECLINE : variation annuelle du chiffre d'affaires par paliers (ampleur ≥10 % / ≥20 %). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE et variantes DECLINE : variation annuelle du résultat net par paliers (≥15 % / ≥30 %). EPS_INCREASE/STRONG_EPS_INCREASE et variantes DECLINE : variation annuelle du BPA par paliers (≥15 % / ≥30 %) ; indépendante du résultat net, car les rachats d'actions peuvent amplifier le mouvement du BPA. CAPEX_INCREASE/STRONG_CAPEX_INCREASE et variantes DECLINE : variation annuelle des dépenses d'investissement en ampleur de dépense (≥15 % / ≥30 %).

          valeurs
          • MARGIN_EXPANSION
          • MARGIN_CONTRACTION
          • GUIDANCE_RAISED
          • GUIDANCE_LOWERED
          • GUIDANCE_REAFFIRMED
        • details
          Type: object

          Champs structurés propres au type de signal. Leur contenu varie : les signaux de guidance portent low, high, point_estimate, prior_value, revision_pct ; les signaux de segment portent best, worst, spread_pp ; les signaux non-GAAP portent gaap_field, non_gaap_value, gaap_value, divergence_pct ; les signaux de croissance portent current, yoy_chg. Les valeurs null sont omises. Reportez-vous aux exemples propres à chaque type.

          • propertyName
            Type: anything
        • metric
          Type: string | null

          La métrique à laquelle ce signal se réfère, le cas échéant (par exemple revenue, earnings_per_share, operating_margin ou le nom d'une métrique de guidance/KPI).

        • period
          Type: string | null

          La période fiscale à laquelle le signal se réfère (par exemple 2026-Q1, FY 2026). Les signaux de guidance prospective se réfèrent à la période visée ; les signaux financiers se réfèrent à la période de référence de ce document.

    • next_page_url
      Type: string

      URL absolue de la page de résultats suivante. Présente uniquement lorsqu'il reste des résultats ; demandez-la telle quelle pour continuer. Chaque page contient jusqu'à 10 enregistrements.

    application/json
  • 400

    La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.

  • 401

    Une clé API Felo valide est requise.

  • 402

    La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.

  • 403

    Le compte n'est pas autorisé à effectuer cette opération.

  • 429

    Une limite de requêtes ou de dépenses a été atteinte.

  • 502

    Le service n'a pas pu terminer la requête.

  • 503

    L'API ou le service de facturation est temporairement indisponible.

  • 504

    Le service a expiré lors du traitement de la requête.

  • default

    Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

    application/json
Request Example for get/v1/beta/financial/earnings
curl 'https://openapi.felo.ai/v1/beta/financial/earnings?ticker=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "earnings": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "fiscal_period": "string",
      "currency": "string",
      "source_type": "8-K",
      "filing_date": "2026-10-26",
      "filing_datetime": null,
      "filing_window": "PRE_MARKET",
      "signals": [
        {
          "type": "MARGIN_EXPANSION",
          "metric": null,
          "period": null,
          "headline": "string",
          "details": {
            "additionalProperty": "anything"
          }
        }
      ],
      "filing_url": "https://example.com",
      "accession_number": "string",
      "quarterly": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      },
      "annual": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      }
    }
  ],
  "next_page_url": "string"
}
Get earnings snapshot