Felo API PlatformFelo API Platform
Alle endpoints van Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Financiële metrics ophalen

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

Financial Data

​

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

Financial Data Operaties

Financiële metrics ophalen

​

Berekende ratio's voor één bedrijf over tijd, ongeveer 49 per periode: 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, de omzet- en liquiditeitsratio's, elk voorzien van report_period en fiscal_period. period is vereist; identificeer via ticker of cik. Gebruik het om een ratio over perioden te volgen. Voor alleen de huidige waarden is get_financial_financial_metrics_snapshot één rij en veel kleiner.

Prijsreferentie

  • Metering: Vaste kostenbasis per geslaagd verzoek.
  • Referentieschatting per verzoek: USD 0.02.
  • Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Queryparameters
  • cik
    Type: string

    De Central Index Key (CIK) van het bedrijf. Kan worden gebruikt in plaats van de ticker.

  • cursor
    Type: string

    Ondoorzichtige pagineringscursor uit de next_page_url van een eerdere respons. Als deze wordt opgegeven, worden alle andere queryparameters genegeerd: de cursor bevat de filters van de oorspronkelijke aanvraag. Behandel hem als ondoorzichtig; construeer of wijzig hem niet.

  • filing_date
    Type: string Formaat: date

    Filteren op exacte SEC-indieningsdatum in de notatie YYYY-MM-DD. Rijen zonder bekend indieningsdatum worden uitgesloten.

  • filing_date_gt
    Type: string Formaat: date

    Filteren op SEC-indieningsdatum na de datum in de notatie YYYY-MM-DD. Rijen zonder bekend indieningsdatum worden uitgesloten.

  • filing_date_gte
    Type: string Formaat: date

    Filteren op SEC-indieningsdatum op of na de datum in de notatie YYYY-MM-DD. Rijen zonder bekend indieningsdatum worden uitgesloten.

  • filing_date_lt
    Type: string Formaat: date

    Filteren op SEC-indieningsdatum vóór de datum in de notatie YYYY-MM-DD. Rijen zonder bekend indieningsdatum worden uitgesloten.

  • filing_date_lte
    Type: string Formaat: date

    Filteren op SEC-indieningsdatum vóór of op de datum in de notatie YYYY-MM-DD. Handig voor point-in-time-query's: retourneert alleen gegevens die op de opgegeven datum openbaar zijn ingediend. Rijen zonder bekend indieningsdatum worden uitgesloten.

  • limit
    Type: integer

    Het maximale aantal resultaten dat moet worden geretourneerd. Dit is het totaal over alle pagina's, niet de paginagrootte: elke pagina bevat maximaal 10 records, gekoppeld via next_page_url.

  • period
    Type: string enum
    verplicht

    De periode voor de financiële gegevens.

    waarden
    • annual
    • quarterly
    • ttm
  • report_period
    Type: string Formaat: date

    Filteren op exacte datum van de rapportageperiode in de notatie YYYY-MM-DD.

  • report_period_gt
    Type: string Formaat: date

    Filteren op rapportageperiode na de datum in de notatie YYYY-MM-DD.

  • report_period_gte
    Type: string Formaat: date

    Filteren op rapportageperiode op of na de datum in de notatie YYYY-MM-DD.

  • report_period_lt
    Type: string Formaat: date

    Filteren op rapportageperiode vóór de datum in de notatie YYYY-MM-DD.

  • report_period_lte
    Type: string Formaat: date

    Filteren op rapportageperiode op of vóór de datum in de notatie YYYY-MM-DD.

  • ticker
    Type: string

    Het tickersymbool van het bedrijf. Verplicht als cik niet is opgegeven.

Responsen
  • 200
    Type: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

    De historische financiële metrics en ratio's voor een ticker

    • accession_number
      Type: string | null

      Het SEC-toegangsnummer van de inzending.

    • asset_turnover
      Type: number

      Omzet gedeeld door de gemiddelde totale activa.

    • book_value_growth
      Type: number

      Jaar-op-jaargroei van de boekwaarde.

    • book_value_per_share
      Type: number

      Eigen vermogen gedeeld door uitstaande aandelen.

    • cash_ratio
      Type: number

      Geldmiddelen en kasequivalenten gedeeld door kortlopende verplichtingen.

    • currency
      Type: string

      De valuta waarin de financiële gegevens worden gerapporteerd.

    • current_ratio
      Type: number

      Vlottende activa gedeeld door kortlopende verplichtingen.

    • days_sales_outstanding
      Type: number

      Gemiddelde vorderingen gedeeld door de omzet over de periode.

    • debt_to_assets
      Type: number

      Totale schulden gedeeld door totale activa.

    • debt_to_equity
      Type: number

      Totale schulden gedeeld door het eigen vermogen.

    • earnings_growth
      Type: number

      Jaar-op-jaargroei van de winst.

    • earnings_per_share
      Type: number

      Nettowinst gedeeld door het gewogen gemiddelde aantal uitstaande aandelen.

    • earnings_per_share_growth
      Type: number

      Groei van de winst per aandeel over de periode.

    • ebitda_growth
      Type: number

      Groei van EBITDA over de periode.

    • enterprise_value
      Type: number

      De totale waarde van het bedrijf (marktkapitalisatie + schuld - geldmiddelen).

    • enterprise_value_to_ebitda_ratio
      Type: number

      Verhouding ondernemingswaarde tot EBITDA.

    • enterprise_value_to_revenue_ratio
      Type: number

      Verhouding ondernemingswaarde tot omzet.

    • filing_date
      Type: string | null Formaat: date

      Kalenderdag waarop de SEC de inzending heeft geaccepteerd, in Eastern Time (de operationele tijdzone van de SEC). Kalenderdag-tegenhanger van filing_datetime. Null wanneer er geen gedateerde SEC-inzending aan de rij is gekoppeld.

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

      Tijdstempel binnen een dag waarop de SEC de inzending in Eastern Time heeft geaccepteerd. Afkomstig uit het veld acceptanceDateTime van de SEC in de EDGAR submissions-API. Hoort bij filing_date (kalenderdagprecisie van dezelfde gebeurtenis).

    • filing_url
      Type: string | null Formaat: uri

      URL naar de SEC-inzending.

    • fiscal_period
      Type: string

      De fiscale periode van de financiële metrieken.

    • form_type
      Type: string | null

      Het SEC-formulier waaruit deze rij afkomstig is (10-K, 10-Q/A, 20-F, S-1, ...). Het exacte formulier zoals ingediend, zodat wijzigingen hun achtervoegsel /A behouden. Null wanneer period gelijk is aan ttm: een venster van twaalf maanden kan meerdere inzendingen omvatten, dus we schrijven het niet aan één toe. Een quarterly-rij kan 10-K bevatten wanneer het vierde kwartaal is afgeleid van de jaarrekening.

    • free_cash_flow_growth
      Type: number

      Groei van de vrije cashflow over de periode.

    • free_cash_flow_per_share
      Type: number

      Vrije cashflow gedeeld door uitstaande aandelen.

    • free_cash_flow_yield
      Type: number

      Rendement op vrije cashflow.

    • gross_margin
      Type: number

      Brutowinst als percentage van de omzet.

    • interest_coverage
      Type: number

      EBIT gedeeld door rentelasten.

    • inventory_turnover
      Type: number

      Kostprijs van verkochte goederen gedeeld door de gemiddelde voorraad.

    • net_margin
      Type: number

      Nettowinst als percentage van de omzet.

    • next_page_url
      Type: string

      Absolute URL van de volgende pagina met resultaten. Alleen aanwezig wanneer er meer resultaten zijn; vraag deze ongewijzigd aan om door te gaan. Elke pagina bevat maximaal 10 records.

    • operating_cash_flow_ratio
      Type: number

      Operationele cashflow gedeeld door kortlopende verplichtingen.

    • operating_cycle
      Type: number

      Voorraadrotatie + vorderingenrotatie.

    • operating_income_growth
      Type: number

      Groei van het operationele resultaat over de periode.

    • operating_margin
      Type: number

      Operationeel resultaat als percentage van de omzet.

    • payout_ratio
      Type: number

      Uitbetaalde dividenden als percentage van de nettowinst.

    • peg_ratio
      Type: number

      Koers-winstgroei-verhouding.

    • period
      Type: string enum

      De periode van de financiële metrieken.

      waarden
      • quarterly
      • ttm
      • annual
    • price_to_book_ratio
      Type: number

      Koers-boekwaardeverhouding.

    • price_to_earnings_ratio
      Type: number

      Koers-winstverhouding.

    • price_to_sales_ratio
      Type: number

      Koers-omzetverhouding.

    • quick_ratio
      Type: number

      Liquide activa gedeeld door kortlopende verplichtingen.

    • receivables_turnover
      Type: number

      Omzet gedeeld door de gemiddelde vorderingen.

    • report_period
      Type: string Formaat: date

      De verslagperiode van de financiële metrieken.

    • return_on_assets
      Type: number

      Nettowinst als percentage van de totale activa.

    • return_on_equity
      Type: number

      Nettowinst als percentage van het eigen vermogen.

    • return_on_invested_capital
      Type: number

      Nettobedrijfswinst na belastingen als percentage van het geïnvesteerde kapitaal.

    • revenue_growth
      Type: number

      Jaar-op-jaargroei van de omzet.

    • ticker
      Type: string

      Het tickersymbool van het bedrijf.

    • working_capital_turnover
      Type: number

      Omzet gedeeld door het gemiddelde werkkapitaal.

    application/json
  • 400

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

    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"
}

De historische financiële metrics en ratio's voor een ticker

Get financial metrics