Felo API PlatformFelo API Platform
Tutti gli endpoint di Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Ottieni lo snapshot dei risultati

Server:https://openapi.felo.ai
Librerie client

Financial Data

​

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

Financial Data Operazioni

Ottieni lo snapshot dei risultati

​

Risultati riportati per un titolo, dati effettivi contro stime. Ogni voce contiene report_period, fiscal_period, filing_date, filing_url e accession_number, un blocco quarterly con revenue, estimated_revenue, revenue_surprise e revenue_surprise_pct, la stessa terna per earnings_per_share, più campi di variazione anno su anno. Restituisce anche signals: flag calcolati a monte come EPS_BEAT con una headline e i valori actual / estimate / surprise_pct alla base. ticker è obbligatorio ed è l'unico parametro. Usalo per ciò che un'azienda ha effettivamente riportato. Per il consenso previsionale che non si è ancora verificato usa get_financial_analyst_estimates.

Riferimento prezzi

  • Misurazione: base di costo fissa per richiesta riuscita.
  • Stima di riferimento per richiesta: USD 0.02.
  • Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Parametri di query
  • cursor
    Tipo: string

    Cursore di paginazione opaco proveniente dal next_page_url di una risposta precedente. Se fornito, tutti gli altri parametri di query vengono ignorati: il cursore contiene i filtri della richiesta originale. Trattalo come opaco; non costruirlo né modificarlo.

  • limit
    Tipo: integer
    min:  
    1
    max:  
    40

    Numero di periodi di rendicontazione più recenti di depositi da restituire, ordinati per (report_period DESC, filing_date ASC). Il numero di voci restituite può superare limit quando un periodo recente contiene sia un 8-K sia un 10-Q / 10-K. I valori superiori a 40 vengono limitati a 40. I valori non positivi o non interi restituiscono 400. Questo è il totale su tutte le pagine, non la dimensione della pagina: ogni pagina contiene fino a 10 record, collegati da next_page_url.

  • ticker
    Tipo: string
    obbligatorio

    Il simbolo ticker (ad es. AAPL).

Risposte
  • 200
    Tipo: object · ResponseE40Feb4D3D6B_EarningsResponse

    Risposta dei risultati

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

      Elenco piatto dei depositi SEC per il ticker, ordinato per (report_period DESC, filing_date ASC). Con limit=N vengono restituiti depositi per un massimo di N report_period; il numero di elementi può superare N quando un periodo recente contiene sia un 8-K sia un 10-Q/10-K.

      • accession_number
        Tipo: string
        obbligatorio

        Numero di accesso SEC che identifica il deposito.

      • filing_date
        Tipo: string Formato: date
        obbligatorio

        Giorno di calendario in cui la SEC ha accettato il deposito, in Eastern Time (il fuso orario operativo della SEC). Controparte a livello di giorno di calendario di filing_datetime.

      • filing_url
        Tipo: string Formato: uri
        obbligatorio

        URL del deposito SEC.

      • report_period
        Tipo: string Formato: date
        obbligatorio

        Periodo di rendicontazione coperto da questo deposito.

      • source_type
        Tipo: string enum
        obbligatorio

        Il tipo di modulo SEC alla base di questo deposito.

        valori
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        Tipo: string
        obbligatorio

        Il simbolo ticker richiesto.

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

          Variazione percentuale delle spese in conto capitale rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • capital_expenditure_yoy_chg
          Tipo: number

          Variazione anno su anno delle spese in conto capitale rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

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

          Variazione percentuale dell'utile per azione rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • earnings_per_share_yoy_chg
          Tipo: number

          Variazione anno su anno dell'utile per azione rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • free_cash_flow
          Tipo: number | null
        • free_cash_flow_chg
          Tipo: number

          Variazione percentuale del flusso di cassa disponibile rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • free_cash_flow_yoy_chg
          Tipo: number

          Variazione anno su anno del flusso di cassa disponibile rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • gross_margin
          Tipo: number

          Margine lordo come decimale (gross_profit / revenue). Restituito solo quando calcolabile.

        • gross_margin_chg_bps
          Tipo: number

          Variazione assoluta del margine lordo rispetto al periodo precedente in punti base (ad es. 200,0 = margine aumentato di 200 pb). Restituita solo quando calcolabile.

        • gross_margin_chg_pct
          Tipo: number

          Variazione percentuale del margine lordo rispetto al periodo precedente, come decimale. Restituita solo quando calcolabile.

        • gross_margin_yoy_chg_bps
          Tipo: number

          Variazione anno su anno del margine lordo rispetto allo stesso trimestre fiscale di un anno prima, in punti base. Solo payload trimestrale. Restituita solo quando calcolabile.

        • gross_margin_yoy_chg_pct
          Tipo: number

          Variazione percentuale anno su anno del margine lordo rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • gross_profit
          Tipo: number | null
        • gross_profit_chg
          Tipo: number

          Variazione percentuale dell'utile lordo rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • gross_profit_yoy_chg
          Tipo: number

          Variazione anno su anno dell'utile lordo rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_cash_flow_from_financing
          Tipo: number | null
        • net_cash_flow_from_financing_chg
          Tipo: number

          Variazione percentuale del flusso di cassa netto da attività di finanziamento rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • net_cash_flow_from_financing_yoy_chg
          Tipo: number

          Variazione anno su anno del flusso di cassa netto da attività di finanziamento rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_cash_flow_from_investing
          Tipo: number | null
        • net_cash_flow_from_investing_chg
          Tipo: number

          Variazione percentuale del flusso di cassa netto da attività di investimento rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • net_cash_flow_from_investing_yoy_chg
          Tipo: number

          Variazione anno su anno del flusso di cassa netto da attività di investimento rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_cash_flow_from_operations
          Tipo: number | null
        • net_cash_flow_from_operations_chg
          Tipo: number

          Variazione percentuale del flusso di cassa netto da attività operativa rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • net_cash_flow_from_operations_yoy_chg
          Tipo: number

          Variazione anno su anno del flusso di cassa netto da attività operativa rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_income
          Tipo: number | null
        • net_income_chg
          Tipo: number

          Variazione percentuale dell'utile netto rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • net_income_yoy_chg
          Tipo: number

          Variazione anno su anno dell'utile netto rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_margin
          Tipo: number

          Margine netto come decimale (net_income / revenue). Restituito solo quando calcolabile.

        • net_margin_chg_bps
          Tipo: number

          Variazione assoluta del margine netto rispetto al periodo precedente in punti base. Restituita solo quando calcolabile.

        • net_margin_chg_pct
          Tipo: number

          Variazione percentuale del margine netto rispetto al periodo precedente, come decimale. Restituita solo quando calcolabile.

        • net_margin_yoy_chg_bps
          Tipo: number

          Variazione anno su anno del margine netto rispetto allo stesso trimestre fiscale di un anno prima, in punti base. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_margin_yoy_chg_pct
          Tipo: number

          Variazione percentuale anno su anno del margine netto rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • operating_income
          Tipo: number | null
        • operating_income_chg
          Tipo: number

          Variazione percentuale del risultato operativo rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • operating_income_yoy_chg
          Tipo: number

          Variazione anno su anno del risultato operativo rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • operating_margin
          Tipo: number

          Margine operativo come decimale (operating_income / revenue). Restituito solo quando calcolabile.

        • operating_margin_chg_bps
          Tipo: number

          Variazione assoluta del margine operativo rispetto al periodo precedente in punti base. Restituita solo quando calcolabile.

        • operating_margin_chg_pct
          Tipo: number

          Variazione percentuale del margine operativo rispetto al periodo precedente, come decimale. Restituita solo quando calcolabile.

        • operating_margin_yoy_chg_bps
          Tipo: number

          Variazione anno su anno del margine operativo rispetto allo stesso trimestre fiscale di un anno prima, in punti base. Solo payload trimestrale. Restituita solo quando calcolabile.

        • operating_margin_yoy_chg_pct
          Tipo: number

          Variazione percentuale anno su anno del margine operativo rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • revenue
          Tipo: number | null
        • revenue_chg
          Tipo: number

          Variazione percentuale dei ricavi rispetto al periodo precedente, come decimale (ad es. 0,10 = +10%). Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • revenue_yoy_chg
          Tipo: number

          Variazione anno su anno dei ricavi rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

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

        Codice valuta ISO (ad es. USD).

      • filing_datetime
        Tipo: string | null Formato: date-time

        Timestamp infragiornaliero che registra quando la SEC ha accettato il deposito, in Eastern Time. Proveniente dal campo acceptanceDateTime della SEC nell'API EDGAR submissions. Si abbina a filing_date (precisione al giorno di calendario dello stesso evento).

      • filing_window
        Tipo: string | null enum

        Sessione di mercato al momento in cui la SEC ha accettato il deposito, valutata in Eastern Time. PRE_MARKET = giorno feriale 04:00–09:30 ET. DURING_MARKET = giorno feriale 09:30–16:00 ET. AFTER_HOURS = giorno feriale al di fuori dell'orario di negoziazione regolare. WEEKEND = sabato o domenica. Nullo quando filing_datetime non è disponibile.

        valori
        • PRE_MARKET
        • DURING_MARKET
        • AFTER_HOURS
        • WEEKEND
      • fiscal_period
        Tipo: string

        Etichetta del periodo fiscale (ad es. 2026-Q1 o 2025-FY).

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

          Variazione percentuale delle spese in conto capitale rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • capital_expenditure_yoy_chg
          Tipo: number

          Variazione anno su anno delle spese in conto capitale rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

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

          Variazione percentuale dell'utile per azione rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • earnings_per_share_yoy_chg
          Tipo: number

          Variazione anno su anno dell'utile per azione rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • free_cash_flow
          Tipo: number | null
        • free_cash_flow_chg
          Tipo: number

          Variazione percentuale del flusso di cassa disponibile rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • free_cash_flow_yoy_chg
          Tipo: number

          Variazione anno su anno del flusso di cassa disponibile rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • gross_margin
          Tipo: number

          Margine lordo come decimale (gross_profit / revenue). Restituito solo quando calcolabile.

        • gross_margin_chg_bps
          Tipo: number

          Variazione assoluta del margine lordo rispetto al periodo precedente in punti base (ad es. 200,0 = margine aumentato di 200 pb). Restituita solo quando calcolabile.

        • gross_margin_chg_pct
          Tipo: number

          Variazione percentuale del margine lordo rispetto al periodo precedente, come decimale. Restituita solo quando calcolabile.

        • gross_margin_yoy_chg_bps
          Tipo: number

          Variazione anno su anno del margine lordo rispetto allo stesso trimestre fiscale di un anno prima, in punti base. Solo payload trimestrale. Restituita solo quando calcolabile.

        • gross_margin_yoy_chg_pct
          Tipo: number

          Variazione percentuale anno su anno del margine lordo rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • gross_profit
          Tipo: number | null
        • gross_profit_chg
          Tipo: number

          Variazione percentuale dell'utile lordo rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • gross_profit_yoy_chg
          Tipo: number

          Variazione anno su anno dell'utile lordo rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_cash_flow_from_financing
          Tipo: number | null
        • net_cash_flow_from_financing_chg
          Tipo: number

          Variazione percentuale del flusso di cassa netto da attività di finanziamento rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • net_cash_flow_from_financing_yoy_chg
          Tipo: number

          Variazione anno su anno del flusso di cassa netto da attività di finanziamento rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_cash_flow_from_investing
          Tipo: number | null
        • net_cash_flow_from_investing_chg
          Tipo: number

          Variazione percentuale del flusso di cassa netto da attività di investimento rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • net_cash_flow_from_investing_yoy_chg
          Tipo: number

          Variazione anno su anno del flusso di cassa netto da attività di investimento rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_cash_flow_from_operations
          Tipo: number | null
        • net_cash_flow_from_operations_chg
          Tipo: number

          Variazione percentuale del flusso di cassa netto da attività operativa rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • net_cash_flow_from_operations_yoy_chg
          Tipo: number

          Variazione anno su anno del flusso di cassa netto da attività operativa rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_income
          Tipo: number | null
        • net_income_chg
          Tipo: number

          Variazione percentuale dell'utile netto rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • net_income_yoy_chg
          Tipo: number

          Variazione anno su anno dell'utile netto rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_margin
          Tipo: number

          Margine netto come decimale (net_income / revenue). Restituito solo quando calcolabile.

        • net_margin_chg_bps
          Tipo: number

          Variazione assoluta del margine netto rispetto al periodo precedente in punti base. Restituita solo quando calcolabile.

        • net_margin_chg_pct
          Tipo: number

          Variazione percentuale del margine netto rispetto al periodo precedente, come decimale. Restituita solo quando calcolabile.

        • net_margin_yoy_chg_bps
          Tipo: number

          Variazione anno su anno del margine netto rispetto allo stesso trimestre fiscale di un anno prima, in punti base. Solo payload trimestrale. Restituita solo quando calcolabile.

        • net_margin_yoy_chg_pct
          Tipo: number

          Variazione percentuale anno su anno del margine netto rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • operating_income
          Tipo: number | null
        • operating_income_chg
          Tipo: number

          Variazione percentuale del risultato operativo rispetto al periodo precedente, come decimale. Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • operating_income_yoy_chg
          Tipo: number

          Variazione anno su anno del risultato operativo rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • operating_margin
          Tipo: number

          Margine operativo come decimale (operating_income / revenue). Restituito solo quando calcolabile.

        • operating_margin_chg_bps
          Tipo: number

          Variazione assoluta del margine operativo rispetto al periodo precedente in punti base. Restituita solo quando calcolabile.

        • operating_margin_chg_pct
          Tipo: number

          Variazione percentuale del margine operativo rispetto al periodo precedente, come decimale. Restituita solo quando calcolabile.

        • operating_margin_yoy_chg_bps
          Tipo: number

          Variazione anno su anno del margine operativo rispetto allo stesso trimestre fiscale di un anno prima, in punti base. Solo payload trimestrale. Restituita solo quando calcolabile.

        • operating_margin_yoy_chg_pct
          Tipo: number

          Variazione percentuale anno su anno del margine operativo rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

        • revenue
          Tipo: number | null
        • revenue_chg
          Tipo: number

          Variazione percentuale dei ricavi rispetto al periodo precedente, come decimale (ad es. 0,10 = +10%). Sequenziale nel payload trimestrale, anno su anno nel payload annuale. Restituita solo quando calcolabile.

        • revenue_yoy_chg
          Tipo: number

          Variazione anno su anno dei ricavi rispetto allo stesso trimestre fiscale di un anno prima, come decimale. Solo payload trimestrale. Restituita solo quando calcolabile.

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

        Approfondimenti curati e rilevanti per il mercato, ricavati da questo deposito. Ogni elemento ha una headline pre-renderizzata, details strutturati e una classificazione importance. Restituito solo quando per questo elemento scatta almeno un segnale; in caso contrario il campo è omesso. Massimo 8 per elemento, ordinati HIGH → MEDIUM → LOW.

        Un approfondimento curato e rilevante per il mercato, ricavato da questo deposito. La headline pre-renderizzata è adatta alla visualizzazione diretta; details contiene campi strutturati per filtraggio e uso programmatico. I segnali vengono restituiti in ordine di priorità (prima i più rilevanti); il type stesso codifica l'entità (ad es. STRONG_REVENUE_INCREASE vs REVENUE_INCREASE).

        • headline
          Tipo: string
          obbligatorio

          Riepilogo pre-renderizzato e leggibile, adatto alla visualizzazione diretta.

        • type
          Tipo: string enum
          obbligatorio

          Categoria del segnale. MARGIN_EXPANSION/MARGIN_CONTRACTION: uno dei margini (lordo, operativo o netto) è variato anno su anno di ≥ 100 pb. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: variazione della guidance prospettica riportata nel deposito. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: il segmento oggetto di rendicontazione con la migliore o peggiore performance in termini di crescita organica dei ricavi. NON_GAAP_DIVERGENCE: una cifra rettificata/non-GAAP differisce in modo significativo dalla corrispondente cifra GAAP nello stesso periodo. BACKLOG_SURGE/BACKLOG_DECLINE: il portafoglio ordini o gli obblighi di performance residui sono variati anno su anno di ≥ 20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE e varianti DECLINE: variazione anno su anno dei ricavi a livelli (entità ≥ 10% / ≥ 20%). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE e varianti DECLINE: variazione anno su anno dell'utile netto a livelli (≥ 15% / ≥ 30%). EPS_INCREASE/STRONG_EPS_INCREASE e varianti DECLINE: variazione anno su anno dell'utile per azione a livelli (≥ 15% / ≥ 30%); indipendente dall'utile netto perché i riacquisti di azioni possono amplificare la variazione dell'EPS. CAPEX_INCREASE/STRONG_CAPEX_INCREASE e varianti DECLINE: variazione anno su anno delle spese in conto capitale a livelli in termini di entità della spesa (≥ 15% / ≥ 30%).

          valori
          • MARGIN_EXPANSION
          • MARGIN_CONTRACTION
          • GUIDANCE_RAISED
          • GUIDANCE_LOWERED
          • GUIDANCE_REAFFIRMED
        • details
          Tipo: object

          Campi strutturati specifici del tipo di segnale. Il contenuto varia: i segnali di guidance contengono low, high, point_estimate, prior_value, revision_pct; i segnali di segmento contengono best, worst, spread_pp; i segnali non-GAAP contengono gaap_field, non_gaap_value, gaap_value, divergence_pct; i segnali di crescita contengono current, yoy_chg. I valori nulli vengono omessi. Fare riferimento agli esempi specifici del tipo.

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

          La metrica a cui fa riferimento questo segnale, se applicabile (ad es. revenue, earnings_per_share, operating_margin o il nome di una metrica di guidance/KPI).

        • period
          Tipo: string | null

          Il periodo fiscale a cui fa riferimento il segnale (ad es. 2026-Q1, FY 2026). I segnali di guidance futura fanno riferimento al periodo previsto; i segnali finanziari fanno riferimento al periodo di rendicontazione di questo deposito.

    • next_page_url
      Tipo: string

      URL assoluto della pagina successiva dei risultati. Presente solo quando restano altri risultati; richiederlo così com'è per continuare. Ogni pagina contiene fino a 10 record.

    application/json
  • 400

    Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

  • 401

    È richiesta una chiave API Felo valida.

  • 402

    Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

  • 403

    L'account non è autorizzato a eseguire questa operazione.

  • 429

    È stato raggiunto un limite di richieste o di spesa.

  • 502

    Il servizio non è riuscito a completare la richiesta.

  • 503

    L'API o il servizio di fatturazione è temporaneamente non disponibile.

  • 504

    Si è verificato un timeout durante l'elaborazione della richiesta.

  • default

    Risposta di errore; le risposte passthrough upstream possono usare formati del provider

    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