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

Ottieni le metriche finanziarie

Felo API Support
MIT
Server:https://openapi.felo.ai
Librerie client
Shell Curl

Financial Data

​

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

Financial Data Operazioni

Ottieni le metriche finanziarie

​

Ratio calcolati per un'azienda nel tempo, circa 49 per periodo: market_cap, enterprise_value, price_to_earnings_ratio, price_to_book_ratio, price_to_sales_ratio, enterprise_value_to_ebitda_ratio, free_cash_flow_yield, peg_ratio, gross_margin, operating_margin, net_margin, return_on_equity, return_on_assets, return_on_invested_capital, i ratio di rotazione e liquidità, ciascuno contrassegnato da report_period e fiscal_period. period è obbligatorio; identifica tramite ticker o cik. Usalo per seguire l'andamento di un ratio tra periodi. Per i soli valori attuali, get_financial_financial_metrics_snapshot è una riga e molto più piccolo.

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à. Può essere usato al posto del ticker.

  • 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

    Il numero massimo di risultati 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 per i dati finanziari.

    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 della società. Obbligatorio se cik non è fornito.

Risposte
  • 200
    Tipo: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

    Le metriche finanziarie storiche e i ratio per un ticker

    • accession_number
      Tipo: string | null

      Il numero di accesso SEC del deposito.

    • asset_turnover
      Tipo: number

      Ricavi divisi per il totale attivo medio.

    • book_value_growth
      Tipo: number

      Crescita anno su anno del valore contabile.

    • book_value_per_share
      Tipo: number

      Patrimonio netto diviso per le azioni in circolazione.

    • cash_ratio
      Tipo: number

      Disponibilità liquide e mezzi equivalenti divisi per le passività correnti.

    • currency
      Tipo: string

      La valuta in cui sono riportati i dati finanziari.

    • current_ratio
      Tipo: number

      Attività correnti divise per le passività correnti.

    • days_sales_outstanding
      Tipo: number

      Crediti medi divisi per i ricavi del periodo.

    • debt_to_assets
      Tipo: number

      Debiti totali divisi per il totale attivo.

    • debt_to_equity
      Tipo: number

      Debiti totali divisi per il patrimonio netto.

    • earnings_growth
      Tipo: number

      Crescita anno su anno degli utili.

    • earnings_per_share
      Tipo: number

      Utile netto diviso per il numero medio ponderato di azioni in circolazione.

    • earnings_per_share_growth
      Tipo: number

      Crescita dell'utile per azione nel periodo.

    • ebitda_growth
      Tipo: number

      Crescita dell'EBITDA nel periodo.

    • enterprise_value
      Tipo: number

      Il valore totale dell'azienda (capitalizzazione di mercato + debiti - liquidità).

    • enterprise_value_to_ebitda_ratio
      Tipo: number

      Rapporto tra valore d'impresa ed EBITDA.

    • enterprise_value_to_revenue_ratio
      Tipo: number

      Rapporto tra valore d'impresa e ricavi.

    • 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 delle metriche finanziarie.

    • 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_growth
      Tipo: number

      Crescita del flusso di cassa disponibile nel periodo.

    • free_cash_flow_per_share
      Tipo: number

      Flusso di cassa disponibile diviso per le azioni in circolazione.

    • free_cash_flow_yield
      Tipo: number

      Rendimento del flusso di cassa disponibile.

    • gross_margin
      Tipo: number

      Utile lordo come percentuale dei ricavi.

    • interest_coverage
      Tipo: number

      EBIT diviso per gli interessi passivi.

    • inventory_turnover
      Tipo: number

      Costo del venduto diviso per la giacenza media.

    • net_margin
      Tipo: number

      Utile netto come percentuale dei ricavi.

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

    • operating_cash_flow_ratio
      Tipo: number

      Flusso di cassa operativo diviso per le passività correnti.

    • operating_cycle
      Tipo: number

      Rotazione delle rimanenze + rotazione dei crediti.

    • operating_income_growth
      Tipo: number

      Crescita del risultato operativo nel periodo.

    • operating_margin
      Tipo: number

      Risultato operativo come percentuale dei ricavi.

    • payout_ratio
      Tipo: number

      Dividendi pagati come percentuale dell'utile netto.

    • peg_ratio
      Tipo: number

      Rapporto prezzo/utili/crescita.

    • period
      Tipo: string enum

      Il periodo delle metriche finanziarie.

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

      Rapporto prezzo/valore contabile.

    • price_to_earnings_ratio
      Tipo: number

      Rapporto prezzo/utili.

    • price_to_sales_ratio
      Tipo: number

      Rapporto prezzo/vendite.

    • quick_ratio
      Tipo: number

      Attività liquide divise per le passività correnti.

    • receivables_turnover
      Tipo: number

      Ricavi divisi per i crediti medi.

    • report_period
      Tipo: string Formato: date

      Il periodo di rendicontazione delle metriche finanziarie.

    • return_on_assets
      Tipo: number

      Utile netto come percentuale del totale attivo.

    • return_on_equity
      Tipo: number

      Utile netto come percentuale del patrimonio netto.

    • return_on_invested_capital
      Tipo: number

      Utile operativo netto dopo le imposte come percentuale del capitale investito.

    • revenue_growth
      Tipo: number

      Crescita anno su anno dei ricavi.

    • ticker
      Tipo: string

      Il simbolo ticker dell'azienda.

    • working_capital_turnover
      Tipo: number

      Ricavi divisi per il capitale circolante medio.

    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/financial-metrics
curl 'https://openapi.felo.ai/v1/beta/financial/financial-metrics?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "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,
  "enterprise_value": 1,
  "price_to_earnings_ratio": 1,
  "price_to_book_ratio": 1,
  "price_to_sales_ratio": 1,
  "enterprise_value_to_ebitda_ratio": 1,
  "enterprise_value_to_revenue_ratio": 1,
  "free_cash_flow_yield": 1,
  "peg_ratio": 1,
  "gross_margin": 1,
  "operating_margin": 1,
  "net_margin": 1,
  "return_on_equity": 1,
  "return_on_assets": 1,
  "return_on_invested_capital": 1,
  "asset_turnover": 1,
  "inventory_turnover": 1,
  "receivables_turnover": 1,
  "days_sales_outstanding": 1,
  "operating_cycle": 1,
  "working_capital_turnover": 1,
  "current_ratio": 1,
  "quick_ratio": 1,
  "cash_ratio": 1,
  "operating_cash_flow_ratio": 1,
  "debt_to_equity": 1,
  "debt_to_assets": 1,
  "interest_coverage": 1,
  "revenue_growth": 1,
  "earnings_growth": 1,
  "book_value_growth": 1,
  "earnings_per_share_growth": 1,
  "free_cash_flow_growth": 1,
  "operating_income_growth": 1,
  "ebitda_growth": 1,
  "payout_ratio": 1,
  "earnings_per_share": 1,
  "book_value_per_share": 1,
  "free_cash_flow_per_share": 1,
  "next_page_url": "string"
}

Le metriche finanziarie storiche e i ratio per un ticker

Get financial metrics