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

Ottieni tutti i prospetti finanziari

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

Financial Data

​

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

Financial Data Operazioni

Ottieni tutti i prospetti finanziari

​

Tutti e tre i prospetti per un'azienda in un'unica chiamata. Restituisce un oggetto financials che contiene income_statements, balance_sheets e cash_flow_statements, ciascuno nella stessa forma restituita dagli strumenti dedicati. period è obbligatorio (annual, quarterly o ttm); identifica l'azienda tramite ticker o cik e limita con limit. Usalo quando ti serve il quadro completo e altrimenti faresti tre chiamate. Quando ti serve un solo prospetto, get_financial_financials_income_statements, get_financial_financials_balance_sheets o get_financial_financials_cash_flow_statements restituiscono molti meno dati; quando ti servono una manciata di campi denominati su più aziende, post_financial_financials_search_line_items è ancora più ristretto.

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
  • cik
    Tipo: string

    Il Central Index Key (CIK) della società.

  • 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.

  • filing_date
    Tipo: string Formato: date

    Filtra per data di deposito SEC esatta nel formato YYYY-MM-DD. Le righe senza una data di deposito nota vengono escluse.

  • filing_date_gt
    Tipo: string Formato: date

    Filtra per data di deposito SEC successiva alla data nel formato YYYY-MM-DD. Le righe senza una data di deposito nota vengono escluse.

  • filing_date_gte
    Tipo: string Formato: date

    Filtra per data di deposito SEC successiva o uguale alla data nel formato YYYY-MM-DD. Le righe senza una data di deposito nota vengono escluse.

  • filing_date_lt
    Tipo: string Formato: date

    Filtra per data di deposito SEC precedente alla data nel formato YYYY-MM-DD. Le righe senza una data di deposito nota vengono escluse.

  • filing_date_lte
    Tipo: string Formato: date

    Filtra per data di deposito SEC precedente o uguale alla data nel formato YYYY-MM-DD. Utile per le query point-in-time: restituisce solo i dati depositati pubblicamente entro la data indicata. Le righe senza una data di deposito nota vengono escluse.

  • limit
    Tipo: integer Formato: int32

    Il numero massimo di bilanci da restituire. Questo è il totale su tutte le pagine, non la dimensione della pagina: ogni pagina contiene fino a 10 record, collegati da next_page_url.

  • period
    Tipo: string enum
    obbligatorio

    Il periodo di riferimento dei bilanci.

    valori
    • annual
    • quarterly
    • ttm
  • report_period
    Tipo: string Formato: date

    Filtra per data esatta del periodo di rendicontazione nel formato YYYY-MM-DD.

  • report_period_gt
    Tipo: string Formato: date

    Filtra per periodo di rendicontazione successivo alla data nel formato YYYY-MM-DD.

  • report_period_gte
    Tipo: string Formato: date

    Filtra per periodo di rendicontazione successivo o uguale alla data nel formato YYYY-MM-DD.

  • report_period_lt
    Tipo: string Formato: date

    Filtra per periodo di rendicontazione precedente alla data nel formato YYYY-MM-DD.

  • report_period_lte
    Tipo: string Formato: date

    Filtra per periodo di rendicontazione precedente o uguale alla data nel formato YYYY-MM-DD.

  • ticker
    Tipo: string

    Il simbolo ticker. Obbligatorio se cik non è fornito.

Risposte
  • 200
    Tipo: object · ResponseE40Feb4D3D6B_FinancialsResponse

    Risposta dei prospetti finanziari

    • financials
      Tipo: object
      • balance_sheets
        Tipo: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
        • accession_number
          Tipo: string | null

          Il numero di accesso SEC del deposito.

        • accumulated_other_comprehensive_income
          Tipo: number

          Le altre componenti accumulate del conto economico complessivo dell'azienda.

        • cash_and_equivalents
          Tipo: number

          Le disponibilità liquide e i mezzi equivalenti dell'azienda.

        • currency
          Tipo: string

          La valuta in cui sono riportati i dati finanziari.

        • current_assets
          Tipo: number

          Le attività correnti dell'azienda.

        • current_debt
          Tipo: number

          I debiti correnti dell'azienda.

        • current_investments
          Tipo: number

          Gli investimenti correnti dell'azienda.

        • current_liabilities
          Tipo: number

          Le passività correnti dell'azienda.

        • deferred_revenue
          Tipo: number

          I ricavi differiti dell'azienda.

        • deposit_liabilities
          Tipo: number

          Le passività per depositi dell'azienda.

        • filing_date
          Tipo: string | null Formato: date

          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. Nullo quando alla riga non è collegato alcun deposito SEC datato.

        • 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_url
          Tipo: string | null Formato: uri

          URL del deposito SEC.

        • fiscal_period
          Tipo: string

          Il periodo fiscale dello stato patrimoniale.

        • form_type
          Tipo: string | null

          Il modulo SEC da cui proviene questa riga (10-K, 10-Q/A, 20-F, S-1, ...). Il modulo esatto così come presentato, quindi le modifiche mantengono il suffisso /A. Nullo quando period è ttm: una finestra di dodici mesi può coprire più depositi, quindi non la attribuiamo a uno solo. Una riga quarterly può riportare 10-K quando il quarto trimestre è derivato dal deposito di bilancio annuale.

        • goodwill_and_intangible_assets
          Tipo: number

          L'avviamento e le attività immateriali dell'azienda.

        • inventory
          Tipo: number

          Le rimanenze dell'azienda.

        • investments
          Tipo: number

          Gli investimenti dell'azienda.

        • non_current_assets
          Tipo: number

          Le attività non correnti dell'azienda.

        • non_current_debt
          Tipo: number

          I debiti non correnti dell'azienda.

        • non_current_investments
          Tipo: number

          Gli investimenti non correnti dell'azienda.

        • non_current_liabilities
          Tipo: number

          Le passività non correnti dell'azienda.

        • outstanding_shares
          Tipo: number

          Le azioni in circolazione dell'azienda.

        • period
          Tipo: string enum

          Il periodo dello stato patrimoniale.

          valori
          • quarterly
          • ttm
          • annual
        • property_plant_and_equipment
          Tipo: number

          Gli immobili, impianti e macchinari dell'azienda.

        • report_period
          Tipo: string Formato: date

          Il periodo di rendicontazione dello stato patrimoniale.

        • retained_earnings
          Tipo: number

          Gli utili portati a nuovo dell'azienda.

        • shareholders_equity
          Tipo: number

          Il patrimonio netto dell'azienda.

        • tax_assets
          Tipo: number

          Le attività fiscali dell'azienda.

        • tax_liabilities
          Tipo: number

          Le passività fiscali dell'azienda.

        • ticker
          Tipo: string

          Il simbolo ticker.

        • total_assets
          Tipo: number

          Il totale attivo dell'azienda.

        • total_debt
          Tipo: number

          I debiti totali dell'azienda.

        • total_liabilities
          Tipo: number

          Le passività totali dell'azienda.

        • trade_and_non_trade_payables
          Tipo: number

          I debiti commerciali e non commerciali dell'azienda.

        • trade_and_non_trade_receivables
          Tipo: number

          I crediti commerciali e non commerciali dell'azienda.

      • cash_flow_statements
        Tipo: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
        • accession_number
          Tipo: string | null

          Il numero di accesso SEC del deposito.

        • business_acquisitions_and_disposals
          Tipo: number

          Le acquisizioni e cessioni di attività aziendali dell'azienda.

        • capital_expenditure
          Tipo: number

          Le spese in conto capitale dell'azienda.

        • change_in_cash_and_equivalents
          Tipo: number

          La variazione delle disponibilità liquide e dei mezzi equivalenti dell'azienda.

        • currency
          Tipo: string

          La valuta in cui sono riportati i dati finanziari.

        • depreciation_and_amortization
          Tipo: number

          Gli ammortamenti dell'azienda.

        • dividends_and_other_cash_distributions
          Tipo: number

          I dividendi e le altre distribuzioni in contanti dell'azienda.

        • effect_of_exchange_rate_changes
          Tipo: number

          L'effetto delle variazioni dei tassi di cambio sull'azienda.

        • ending_cash_balance
          Tipo: number

          Il saldo di cassa finale dell'azienda.

        • filing_date
          Tipo: string | null Formato: date

          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. Nullo quando alla riga non è collegato alcun deposito SEC datato.

        • 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_url
          Tipo: string | null Formato: uri

          URL del deposito SEC.

        • fiscal_period
          Tipo: string

          Il periodo fiscale del rendiconto dei flussi di cassa.

        • form_type
          Tipo: string | null

          Il modulo SEC da cui proviene questa riga (10-K, 10-Q/A, 20-F, S-1, ...). Il modulo esatto così come presentato, quindi le modifiche mantengono il suffisso /A. Nullo quando period è ttm: una finestra di dodici mesi può coprire più depositi, quindi non la attribuiamo a uno solo. Una riga quarterly può riportare 10-K quando il quarto trimestre è derivato dal deposito di bilancio annuale.

        • free_cash_flow
          Tipo: number

          Il flusso di cassa disponibile dell'azienda.

        • investment_acquisitions_and_disposals
          Tipo: number

          Le acquisizioni e cessioni di investimenti dell'azienda.

        • issuance_or_purchase_of_equity_shares
          Tipo: number

          L'emissione o l'acquisto di azioni di capitale dell'azienda.

        • issuance_or_repayment_of_debt_securities
          Tipo: number

          L'emissione o il rimborso di titoli di debito dell'azienda.

        • net_cash_flow_from_financing
          Tipo: number

          Il flusso di cassa netto da attività di finanziamento dell'azienda.

        • net_cash_flow_from_investing
          Tipo: number

          Il flusso di cassa netto da attività di investimento dell'azienda.

        • net_cash_flow_from_operations
          Tipo: number

          Il flusso di cassa netto da attività operativa dell'azienda.

        • net_income
          Tipo: number

          L'utile netto dell'azienda.

        • period
          Tipo: string enum

          Il periodo del rendiconto dei flussi di cassa.

          valori
          • quarterly
          • ttm
          • annual
        • report_period
          Tipo: string Formato: date

          Il periodo di rendicontazione del rendiconto dei flussi di cassa.

        • share_based_compensation
          Tipo: number

          I compensi basati su azioni dell'azienda.

        • ticker
          Tipo: string

          Il simbolo ticker.

      • income_statements
        Tipo: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
        • accession_number
          Tipo: string | null

          Il numero di accesso SEC del deposito.

        • consolidated_income
          Tipo: number

          Il risultato consolidato dell'azienda.

        • cost_of_revenue
          Tipo: number

          Il costo dei ricavi dell'azienda.

        • currency
          Tipo: string

          La valuta in cui sono riportati i dati finanziari.

        • dividends_per_common_share
          Tipo: number

          I dividendi per azione ordinaria dell'azienda.

        • earnings_per_share
          Tipo: number

          L'utile per azione dell'azienda.

        • earnings_per_share_diluted
          Tipo: number

          L'utile diluito per azione dell'azienda.

        • ebit
          Tipo: number

          L'utile prima degli interessi e delle imposte dell'azienda.

        • filing_date
          Tipo: string | null Formato: date

          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. Nullo quando alla riga non è collegato alcun deposito SEC datato.

        • 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_url
          Tipo: string | null Formato: uri

          URL del deposito SEC.

        • fiscal_period
          Tipo: string

          Il periodo fiscale del conto economico.

        • form_type
          Tipo: string | null

          Il modulo SEC da cui proviene questa riga (10-K, 10-Q/A, 20-F, S-1, ...). Il modulo esatto così come presentato, quindi le modifiche mantengono il suffisso /A. Nullo quando period è ttm: una finestra di dodici mesi può coprire più depositi, quindi non la attribuiamo a uno solo. Una riga quarterly può riportare 10-K quando il quarto trimestre è derivato dal deposito di bilancio annuale.

        • gross_profit
          Tipo: number

          L'utile lordo dell'azienda.

        • income_tax_expense
          Tipo: number

          Le imposte sul reddito dell'azienda.

        • interest_expense
          Tipo: number

          Gli interessi passivi dell'azienda.

        • net_income
          Tipo: number

          L'utile netto dell'azienda.

        • net_income_common_stock
          Tipo: number

          L'utile netto disponibile per gli azionisti ordinari dell'azienda.

        • net_income_discontinued_operations
          Tipo: number

          L'utile netto delle attività operative cessate dell'azienda.

        • net_income_non_controlling_interests
          Tipo: number

          L'utile netto delle interessenze di minoranza dell'azienda.

        • operating_expense
          Tipo: number

          I costi operativi dell'azienda.

        • operating_income
          Tipo: number

          Il risultato operativo dell'azienda.

        • period
          Tipo: string enum

          Il periodo del conto economico.

          valori
          • quarterly
          • ttm
          • annual
        • preferred_dividends_impact
          Tipo: number

          L'impatto dei dividendi privilegiati sull'utile netto dell'azienda.

        • report_period
          Tipo: string Formato: date

          Il periodo di rendicontazione del conto economico.

        • research_and_development
          Tipo: number

          Le spese di ricerca e sviluppo dell'azienda.

        • revenue
          Tipo: number

          I ricavi totali dell'azienda.

        • selling_general_and_administrative_expenses
          Tipo: number

          Le spese di vendita, generali e amministrative dell'azienda.

        • ticker
          Tipo: string

          Il simbolo ticker.

        • weighted_average_shares
          Tipo: number

          Il numero medio ponderato di azioni dell'azienda.

        • weighted_average_shares_diluted
          Tipo: number

          Il numero medio ponderato diluito di azioni dell'azienda.

    • 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/financials
curl 'https://openapi.felo.ai/v1/beta/financial/financials?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "financials": {
    "income_statements": [
      {
        "ticker": "string",
        "report_period": "2026-10-26",
        "fiscal_period": "string",
        "period": "quarterly",
        "currency": "string",
        "accession_number": null,
        "form_type": null,
        "filing_url": null,
        "filing_date": null,
        "filing_datetime": null,
        "revenue": 1,
        "cost_of_revenue": 1,
        "gross_profit": 1,
        "operating_expense": 1,
        "selling_general_and_administrative_expenses": 1,
        "research_and_development": 1,
        "operating_income": 1,
        "interest_expense": 1,
        "ebit": 1,
        "income_tax_expense": 1,
        "net_income_discontinued_operations": 1,
        "net_income_non_controlling_interests": 1,
        "net_income": 1,
        "net_income_common_stock": 1,
        "preferred_dividends_impact": 1,
        "consolidated_income": 1,
        "earnings_per_share": 1,
        "earnings_per_share_diluted": 1,
        "dividends_per_common_share": 1,
        "weighted_average_shares": 1,
        "weighted_average_shares_diluted": 1
      }
    ],
    "balance_sheets": [
      {
        "ticker": "string",
        "report_period": "2026-10-26",
        "fiscal_period": "string",
        "period": "quarterly",
        "currency": "string",
        "accession_number": null,
        "form_type": null,
        "filing_url": null,
        "filing_date": null,
        "filing_datetime": null,
        "total_assets": 1,
        "current_assets": 1,
        "cash_and_equivalents": 1,
        "inventory": 1,
        "current_investments": 1,
        "trade_and_non_trade_receivables": 1,
        "non_current_assets": 1,
        "property_plant_and_equipment": 1,
        "goodwill_and_intangible_assets": 1,
        "investments": 1,
        "non_current_investments": 1,
        "outstanding_shares": 1,
        "tax_assets": 1,
        "total_liabilities": 1,
        "current_liabilities": 1,
        "current_debt": 1,
        "trade_and_non_trade_payables": 1,
        "deferred_revenue": 1,
        "deposit_liabilities": 1,
        "non_current_liabilities": 1,
        "non_current_debt": 1,
        "tax_liabilities": 1,
        "shareholders_equity": 1,
        "retained_earnings": 1,
        "accumulated_other_comprehensive_income": 1,
        "total_debt": 1
      }
    ],
    "cash_flow_statements": [
      {
        "ticker": "string",
        "report_period": "2026-10-26",
        "fiscal_period": "string",
        "period": "quarterly",
        "currency": "string",
        "accession_number": null,
        "form_type": null,
        "filing_url": null,
        "filing_date": null,
        "filing_datetime": null,
        "net_income": 1,
        "depreciation_and_amortization": 1,
        "share_based_compensation": 1,
        "net_cash_flow_from_operations": 1,
        "capital_expenditure": 1,
        "business_acquisitions_and_disposals": 1,
        "investment_acquisitions_and_disposals": 1,
        "net_cash_flow_from_investing": 1,
        "issuance_or_repayment_of_debt_securities": 1,
        "issuance_or_purchase_of_equity_shares": 1,
        "dividends_and_other_cash_distributions": 1,
        "net_cash_flow_from_financing": 1,
        "change_in_cash_and_equivalents": 1,
        "effect_of_exchange_rate_changes": 1,
        "ending_cash_balance": 1,
        "free_cash_flow": 1
      }
    ]
  },
  "next_page_url": "string"
}
Get all financial statements