Felo API PlatformFelo API Platform
Alle Endpoints von Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Ergebnis-Snapshot abrufen

Server:https://openapi.felo.ai
Client-Bibliotheken

Financial Data

​

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

Financial Data Operationen

Ergebnis-Snapshot abrufen

​

Berichtete Ergebnisse für eine Aktie, Ist-Werte gegen Schätzungen. Jeder Eintrag enthält report_period, fiscal_period, filing_date, filing_url und accession_number, einen quarterly-Block mit revenue, estimated_revenue, revenue_surprise und revenue_surprise_pct, dieselbe Dreiergruppe für earnings_per_share sowie Felder zur Veränderung gegenüber dem Vorjahr. Außerdem werden signals zurückgegeben: upstream berechnete Flags wie EPS_BEAT mit einer headline und den dahinterstehenden Werten actual / estimate / surprise_pct. ticker ist erforderlich und der einzige Parameter. Nutzen Sie es für das, was ein Unternehmen tatsächlich berichtet hat. Für den vorausschauenden Konsens, der noch nicht eingetreten ist, nutzen Sie get_financial_analyst_estimates.

Preisreferenz

  • Abrechnung: Feste Kostenbasis pro erfolgreicher Anfrage.
  • Referenzschätzung pro Anfrage: USD 0.02.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Query-Parameter
  • cursor
    Typ: string

    Undurchsichtiger Paginierungs-Cursor aus der next_page_url einer vorherigen Antwort. Wenn er angegeben wird, werden alle anderen Query-Parameter ignoriert: Der Cursor enthält die Filter der ursprünglichen Anfrage. Behandeln Sie ihn als undurchsichtig; konstruieren oder ändern Sie ihn nicht.

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

    Anzahl der letzten Berichtsperioden an Einreichungen, die zurückgegeben werden, sortiert nach (report_period DESC, filing_date ASC). Die Anzahl der zurückgegebenen Einträge kann limit überschreiten, wenn eine aktuelle Periode sowohl ein 8-K als auch ein 10-Q / 10-K enthält. Werte über 40 werden auf 40 begrenzt. Nicht positive oder nicht ganzzahlige Werte führen zu 400. Dies ist die Gesamtzahl über alle Seiten, keine Seitengröße: Jede Seite enthält bis zu 10 Datensätze, die über next_page_url verknüpft sind.

  • ticker
    Typ: string
    erforderlich

    Das Tickersymbol (z. B. AAPL).

Antworten
  • 200
    Typ: object · ResponseE40Feb4D3D6B_EarningsResponse

    Ergebnis-Antwort

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

      Flache Liste der SEC-Einreichungen für den Ticker, sortiert nach (report_period DESC, filing_date ASC). Bei limit=N werden bis zu N report_periods an Einreichungen zurückgegeben; die Anzahl der Einträge kann N überschreiten, wenn ein aktueller Zeitraum sowohl ein 8-K als auch ein 10-Q/10-K enthält.

      • accession_number
        Typ: string
        erforderlich

        SEC-Accession-Nummer, die die Einreichung identifiziert.

      • filing_date
        Typ: string Format: date
        erforderlich

        Kalendertag, an dem die SEC die Einreichung angenommen hat, in Eastern Time (der Betriebszeitzone der SEC). Kalendertag-Pendant zu filing_datetime.

      • filing_url
        Typ: string Format: uri
        erforderlich

        URL zur SEC-Einreichung.

      • report_period
        Typ: string Format: date
        erforderlich

        Berichtszeitraum, den diese Einreichung abdeckt.

      • source_type
        Typ: string enum
        erforderlich

        Der SEC-Formulartyp, auf dem diese Einreichung basiert.

        Werte
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        Typ: string
        erforderlich

        Das angeforderte Tickersymbol.

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

          Prozentuale Veränderung der Investitionsausgaben gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • capital_expenditure_yoy_chg
          Typ: number

          Veränderung der Investitionsausgaben im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

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

          Prozentuale Veränderung des Gewinns je Aktie gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • earnings_per_share_yoy_chg
          Typ: number

          Veränderung des Gewinns je Aktie im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • free_cash_flow
          Typ: number | null
        • free_cash_flow_chg
          Typ: number

          Prozentuale Veränderung des freien Cashflows gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • free_cash_flow_yoy_chg
          Typ: number

          Veränderung des freien Cashflows im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • gross_margin
          Typ: number

          Bruttomarge als Dezimalzahl (gross_profit / revenue). Wird nur zurückgegeben, wenn berechenbar.

        • gross_margin_chg_bps
          Typ: number

          Absolute Veränderung der Bruttomarge gegenüber dem vorherigen Zeitraum in Basispunkten (z. B. 200,0 = Marge um 200 Basispunkte gestiegen). Wird nur zurückgegeben, wenn berechenbar.

        • gross_margin_chg_pct
          Typ: number

          Prozentuale Veränderung der Bruttomarge gegenüber dem vorherigen Zeitraum als Dezimalzahl. Wird nur zurückgegeben, wenn berechenbar.

        • gross_margin_yoy_chg_bps
          Typ: number

          Veränderung der Bruttomarge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, in Basispunkten. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • gross_margin_yoy_chg_pct
          Typ: number

          Prozentuale Veränderung der Bruttomarge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • gross_profit
          Typ: number | null
        • gross_profit_chg
          Typ: number

          Prozentuale Veränderung des Bruttogewinns gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • gross_profit_yoy_chg
          Typ: number

          Veränderung des Bruttogewinns im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_financing
          Typ: number | null
        • net_cash_flow_from_financing_chg
          Typ: number

          Prozentuale Veränderung des Netto-Cashflows aus Finanzierungstätigkeit gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_financing_yoy_chg
          Typ: number

          Veränderung des Netto-Cashflows aus Finanzierungstätigkeit im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_investing
          Typ: number | null
        • net_cash_flow_from_investing_chg
          Typ: number

          Prozentuale Veränderung des Netto-Cashflows aus Investitionstätigkeit gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_investing_yoy_chg
          Typ: number

          Veränderung des Netto-Cashflows aus Investitionstätigkeit im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_operations
          Typ: number | null
        • net_cash_flow_from_operations_chg
          Typ: number

          Prozentuale Veränderung des Netto-Cashflows aus betrieblicher Tätigkeit gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_operations_yoy_chg
          Typ: number

          Veränderung des Netto-Cashflows aus betrieblicher Tätigkeit im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_income
          Typ: number | null
        • net_income_chg
          Typ: number

          Prozentuale Veränderung des Nettogewinns gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • net_income_yoy_chg
          Typ: number

          Veränderung des Nettogewinns im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_margin
          Typ: number

          Nettomarge als Dezimalzahl (net_income / revenue). Wird nur zurückgegeben, wenn berechenbar.

        • net_margin_chg_bps
          Typ: number

          Absolute Veränderung der Nettomarge gegenüber dem vorherigen Zeitraum in Basispunkten. Wird nur zurückgegeben, wenn berechenbar.

        • net_margin_chg_pct
          Typ: number

          Prozentuale Veränderung der Nettomarge gegenüber dem vorherigen Zeitraum als Dezimalzahl. Wird nur zurückgegeben, wenn berechenbar.

        • net_margin_yoy_chg_bps
          Typ: number

          Veränderung der Nettomarge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, in Basispunkten. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_margin_yoy_chg_pct
          Typ: number

          Prozentuale Veränderung der Nettomarge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • operating_income
          Typ: number | null
        • operating_income_chg
          Typ: number

          Prozentuale Veränderung des Betriebsergebnisses gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • operating_income_yoy_chg
          Typ: number

          Veränderung des Betriebsergebnisses im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • operating_margin
          Typ: number

          Operative Marge als Dezimalzahl (operating_income / revenue). Wird nur zurückgegeben, wenn berechenbar.

        • operating_margin_chg_bps
          Typ: number

          Absolute Veränderung der operativen Marge gegenüber dem vorherigen Zeitraum in Basispunkten. Wird nur zurückgegeben, wenn berechenbar.

        • operating_margin_chg_pct
          Typ: number

          Prozentuale Veränderung der operativen Marge gegenüber dem vorherigen Zeitraum als Dezimalzahl. Wird nur zurückgegeben, wenn berechenbar.

        • operating_margin_yoy_chg_bps
          Typ: number

          Veränderung der operativen Marge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, in Basispunkten. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • operating_margin_yoy_chg_pct
          Typ: number

          Prozentuale Veränderung der operativen Marge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • revenue
          Typ: number | null
        • revenue_chg
          Typ: number

          Prozentuale Veränderung des Umsatzes gegenüber dem vorherigen Zeitraum als Dezimalzahl (z. B. 0,10 = +10 %). In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • revenue_yoy_chg
          Typ: number

          Veränderung des Umsatzes im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

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

        ISO-Währungscode (z. B. USD).

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

        Zeitstempel unterhalb der Tagesauflösung, der festhält, wann die SEC die Einreichung in Eastern Time angenommen hat. Stammt aus dem Feld acceptanceDateTime der SEC in der EDGAR-Submissions-API. Passt zu filing_date (Kalendertag-Auflösung desselben Ereignisses).

      • filing_window
        Typ: string | null enum

        Marktsitzung zum Zeitpunkt der Annahme der Einreichung durch die SEC, bewertet in Eastern Time. PRE_MARKET = Werktag 04:00–09:30 ET. DURING_MARKET = Werktag 09:30–16:00 ET. AFTER_HOURS = Werktag außerhalb der regulären Handelszeiten. WEEKEND = Samstag oder Sonntag. Null, wenn filing_datetime nicht verfügbar ist.

        Werte
        • PRE_MARKET
        • DURING_MARKET
        • AFTER_HOURS
        • WEEKEND
      • fiscal_period
        Typ: string

        Bezeichnung der Fiskalperiode (z. B. 2026-Q1 oder 2025-FY).

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

          Prozentuale Veränderung der Investitionsausgaben gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • capital_expenditure_yoy_chg
          Typ: number

          Veränderung der Investitionsausgaben im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

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

          Prozentuale Veränderung des Gewinns je Aktie gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • earnings_per_share_yoy_chg
          Typ: number

          Veränderung des Gewinns je Aktie im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • free_cash_flow
          Typ: number | null
        • free_cash_flow_chg
          Typ: number

          Prozentuale Veränderung des freien Cashflows gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • free_cash_flow_yoy_chg
          Typ: number

          Veränderung des freien Cashflows im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • gross_margin
          Typ: number

          Bruttomarge als Dezimalzahl (gross_profit / revenue). Wird nur zurückgegeben, wenn berechenbar.

        • gross_margin_chg_bps
          Typ: number

          Absolute Veränderung der Bruttomarge gegenüber dem vorherigen Zeitraum in Basispunkten (z. B. 200,0 = Marge um 200 Basispunkte gestiegen). Wird nur zurückgegeben, wenn berechenbar.

        • gross_margin_chg_pct
          Typ: number

          Prozentuale Veränderung der Bruttomarge gegenüber dem vorherigen Zeitraum als Dezimalzahl. Wird nur zurückgegeben, wenn berechenbar.

        • gross_margin_yoy_chg_bps
          Typ: number

          Veränderung der Bruttomarge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, in Basispunkten. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • gross_margin_yoy_chg_pct
          Typ: number

          Prozentuale Veränderung der Bruttomarge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • gross_profit
          Typ: number | null
        • gross_profit_chg
          Typ: number

          Prozentuale Veränderung des Bruttogewinns gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • gross_profit_yoy_chg
          Typ: number

          Veränderung des Bruttogewinns im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_financing
          Typ: number | null
        • net_cash_flow_from_financing_chg
          Typ: number

          Prozentuale Veränderung des Netto-Cashflows aus Finanzierungstätigkeit gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_financing_yoy_chg
          Typ: number

          Veränderung des Netto-Cashflows aus Finanzierungstätigkeit im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_investing
          Typ: number | null
        • net_cash_flow_from_investing_chg
          Typ: number

          Prozentuale Veränderung des Netto-Cashflows aus Investitionstätigkeit gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_investing_yoy_chg
          Typ: number

          Veränderung des Netto-Cashflows aus Investitionstätigkeit im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_operations
          Typ: number | null
        • net_cash_flow_from_operations_chg
          Typ: number

          Prozentuale Veränderung des Netto-Cashflows aus betrieblicher Tätigkeit gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • net_cash_flow_from_operations_yoy_chg
          Typ: number

          Veränderung des Netto-Cashflows aus betrieblicher Tätigkeit im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_income
          Typ: number | null
        • net_income_chg
          Typ: number

          Prozentuale Veränderung des Nettogewinns gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • net_income_yoy_chg
          Typ: number

          Veränderung des Nettogewinns im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_margin
          Typ: number

          Nettomarge als Dezimalzahl (net_income / revenue). Wird nur zurückgegeben, wenn berechenbar.

        • net_margin_chg_bps
          Typ: number

          Absolute Veränderung der Nettomarge gegenüber dem vorherigen Zeitraum in Basispunkten. Wird nur zurückgegeben, wenn berechenbar.

        • net_margin_chg_pct
          Typ: number

          Prozentuale Veränderung der Nettomarge gegenüber dem vorherigen Zeitraum als Dezimalzahl. Wird nur zurückgegeben, wenn berechenbar.

        • net_margin_yoy_chg_bps
          Typ: number

          Veränderung der Nettomarge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, in Basispunkten. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • net_margin_yoy_chg_pct
          Typ: number

          Prozentuale Veränderung der Nettomarge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • operating_income
          Typ: number | null
        • operating_income_chg
          Typ: number

          Prozentuale Veränderung des Betriebsergebnisses gegenüber dem vorherigen Zeitraum als Dezimalzahl. In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • operating_income_yoy_chg
          Typ: number

          Veränderung des Betriebsergebnisses im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • operating_margin
          Typ: number

          Operative Marge als Dezimalzahl (operating_income / revenue). Wird nur zurückgegeben, wenn berechenbar.

        • operating_margin_chg_bps
          Typ: number

          Absolute Veränderung der operativen Marge gegenüber dem vorherigen Zeitraum in Basispunkten. Wird nur zurückgegeben, wenn berechenbar.

        • operating_margin_chg_pct
          Typ: number

          Prozentuale Veränderung der operativen Marge gegenüber dem vorherigen Zeitraum als Dezimalzahl. Wird nur zurückgegeben, wenn berechenbar.

        • operating_margin_yoy_chg_bps
          Typ: number

          Veränderung der operativen Marge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, in Basispunkten. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • operating_margin_yoy_chg_pct
          Typ: number

          Prozentuale Veränderung der operativen Marge im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

        • revenue
          Typ: number | null
        • revenue_chg
          Typ: number

          Prozentuale Veränderung des Umsatzes gegenüber dem vorherigen Zeitraum als Dezimalzahl (z. B. 0,10 = +10 %). In der Quartalsantwort sequenziell, in der Jahresantwort im Jahresvergleich. Wird nur zurückgegeben, wenn berechenbar.

        • revenue_yoy_chg
          Typ: number

          Veränderung des Umsatzes im Jahresvergleich gegenüber demselben Fiskalquartal des Vorjahres, als Dezimalzahl. Nur in der Quartalsantwort. Wird nur zurückgegeben, wenn berechenbar.

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

        Kuratierte, marktbewegende Erkenntnisse, die aus dieser Einreichung gewonnen wurden. Jeder Eintrag hat eine vorgerenderte headline, strukturierte details und ein importance-Ranking. Wird nur zurückgegeben, wenn für diesen Eintrag mindestens ein Signal ausgelöst wird; andernfalls entfällt das Feld. Maximal 8 pro Eintrag, sortiert nach HIGH → MEDIUM → LOW.

        Ein kuratierter, marktbewegender Einblick aus dieser Einreichung. Die vorgerenderte headline eignet sich zur direkten Anzeige; details enthält strukturierte Felder zum Filtern und für die programmatische Nutzung. Signale werden in Prioritätsreihenfolge zurückgegeben (wichtigstes zuerst); der type selbst kodiert die Größenordnung (z. B. STRONG_REVENUE_INCREASE vs. REVENUE_INCREASE).

        • headline
          Typ: string
          erforderlich

          Vorgerenderte, menschenlesbare Zusammenfassung, geeignet zur direkten Anzeige.

        • type
          Typ: string enum
          erforderlich

          Signalkategorie. MARGIN_EXPANSION/MARGIN_CONTRACTION: Eine der Margen (Brutto-, operativ oder netto) hat sich im Jahresvergleich um ≥ 100 Basispunkte verändert. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: In der Einreichung gemeldete Änderung der zukunftsgerichteten Guidance. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: das beste bzw. schlechteste berichtspflichtige Segment nach organischem Umsatzwachstum. NON_GAAP_DIVERGENCE: Eine bereinigte/Non-GAAP-Kennzahl weicht für denselben Zeitraum wesentlich von ihrem GAAP-Pendant ab. BACKLOG_SURGE/BACKLOG_DECLINE: Auftragsbestand oder verbleibende Leistungsverpflichtungen haben sich im Jahresvergleich um ≥ 20 % verändert. REVENUE_INCREASE/STRONG_REVENUE_INCREASE und DECLINE-Varianten: abgestufte Umsatzveränderung im Jahresvergleich (Größenordnung ≥ 10 % / ≥ 20 %). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE und DECLINE-Varianten: abgestufte Nettogewinnveränderung im Jahresvergleich (≥ 15 % / ≥ 30 %). EPS_INCREASE/STRONG_EPS_INCREASE und DECLINE-Varianten: abgestufte Veränderung des Gewinns je Aktie im Jahresvergleich (≥ 15 % / ≥ 30 %); unabhängig vom Nettogewinn, da Aktienrückkäufe die EPS-Bewegung verstärken können. CAPEX_INCREASE/STRONG_CAPEX_INCREASE und DECLINE-Varianten: abgestufte Veränderung der Investitionsausgaben im Jahresvergleich in der Ausgabenhöhe (≥ 15 % / ≥ 30 %).

          Werte
          • MARGIN_EXPANSION
          • MARGIN_CONTRACTION
          • GUIDANCE_RAISED
          • GUIDANCE_LOWERED
          • GUIDANCE_REAFFIRMED
        • details
          Typ: object

          Strukturierte Felder spezifisch für den Signaltyp. Der Inhalt variiert: Guidance-Signale enthalten low, high, point_estimate, prior_value, revision_pct; Segment-Signale enthalten best, worst, spread_pp; Non-GAAP-Signale enthalten gaap_field, non_gaap_value, gaap_value, divergence_pct; Wachstumssignale enthalten current, yoy_chg. Nullwerte werden weggelassen. Beziehen Sie sich auf die typspezifischen Beispiele.

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

          Die Kennzahl, auf die sich dieses Signal bezieht, sofern zutreffend (z. B. revenue, earnings_per_share, operating_margin oder ein Guidance-/KPI-Kennzahlenname).

        • period
          Typ: string | null

          Die Fiskalperiode, auf die sich das Signal bezieht (z. B. 2026-Q1, FY 2026). Forward-Guidance-Signale beziehen sich auf den geführten Zeitraum; Finanzsignale beziehen sich auf den Berichtszeitraum dieser Einreichung.

    • next_page_url
      Typ: string

      Absolute URL der nächsten Ergebnisseite. Nur vorhanden, wenn weitere Ergebnisse verbleiben; fordern Sie sie unverändert an, um fortzufahren. Jede Seite enthält bis zu 10 Datensätze.

    application/json
  • 400

    Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.

  • 401

    Ein gültiger Felo-API-Schlüssel ist erforderlich.

  • 402

    Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.

  • 403

    Das Konto ist für diesen Vorgang nicht berechtigt.

  • 429

    Ein Anfrage- oder Ausgabenlimit wurde erreicht.

  • 502

    Der Dienst konnte die Anfrage nicht abschließen.

  • 503

    Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.

  • 504

    Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.

  • default

    Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

    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