Felo API PlatformFelo API Platform
Wszystkie endpointy Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Pobierz metryki finansowe

Felo API Support
MIT
Serwer:https://openapi.felo.ai
Biblioteki klienckie
Shell Curl

Financial Data

​

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

Financial Data Operacje

Pobierz metryki finansowe

​

Obliczone wskaźniki dla jednej spółki w czasie, około 49 na okres: 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, wskaźniki rotacji i płynności, każdy opatrzony report_period i fiscal_period. period jest wymagane; identyfikuj przez ticker lub cik. Używaj go do śledzenia trendu wskaźnika w kolejnych okresach. Dla samych bieżących wartości get_financial_financial_metrics_snapshot to jeden wiersz i znacznie mniej danych.

Cennik referencyjny

  • Rozliczanie: stała podstawa kosztu za udane żądanie.
  • Szacunek referencyjny dla żądania: USD 0.02.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Parametry zapytania
  • cik
    Typ: string

    Central Index Key (CIK) spółki. Można użyć zamiast tickera.

  • cursor
    Typ: string

    Nieprzezroczysty kursor paginacji z next_page_url poprzedniej odpowiedzi. Po jego podaniu wszystkie pozostałe parametry zapytania są ignorowane: kursor przenosi filtry pierwotnego żądania. Traktuj go jako nieprzezroczysty; nie konstruuj go ani nie modyfikuj.

  • filing_date
    Typ: string Format: date

    Filtruj według dokładnej daty złożenia w SEC w formacie YYYY-MM-DD. Wiersze bez znanej daty złożenia są pomijane.

  • filing_date_gt
    Typ: string Format: date

    Filtruj według daty złożenia w SEC późniejszej niż date w formacie YYYY-MM-DD. Wiersze bez znanej daty złożenia są pomijane.

  • filing_date_gte
    Typ: string Format: date

    Filtruj według daty złożenia w SEC późniejszej lub równej date w formacie YYYY-MM-DD. Wiersze bez znanej daty złożenia są pomijane.

  • filing_date_lt
    Typ: string Format: date

    Filtruj według daty złożenia w SEC wcześniejszej niż date w formacie YYYY-MM-DD. Wiersze bez znanej daty złożenia są pomijane.

  • filing_date_lte
    Typ: string Format: date

    Filtruj według daty złożenia w SEC wcześniejszej lub równej date w formacie YYYY-MM-DD. Przydatne do zapytań w określonym momencie: zwraca tylko dane, które zostały publicznie złożone do podanej daty. Wiersze bez znanej daty złożenia są pomijane.

  • limit
    Typ: integer

    Maksymalna liczba wyników do zwrócenia. To suma łączna na wszystkich stronach, a nie rozmiar strony: każda strona zawiera do 10 rekordów połączonych przez next_page_url.

  • period
    Typ: string enum
    wymagane

    Okres danych finansowych.

    wartości
    • annual
    • quarterly
    • ttm
  • report_period
    Typ: string Format: date

    Filtruj według dokładnej daty okresu sprawozdawczego w formacie YYYY-MM-DD.

  • report_period_gt
    Typ: string Format: date

    Filtruj według okresu sprawozdawczego późniejszego niż data w formacie YYYY-MM-DD.

  • report_period_gte
    Typ: string Format: date

    Filtruj według okresu sprawozdawczego późniejszego lub równego dacie w formacie YYYY-MM-DD.

  • report_period_lt
    Typ: string Format: date

    Filtruj według okresu sprawozdawczego wcześniejszego niż data w formacie YYYY-MM-DD.

  • report_period_lte
    Typ: string Format: date

    Filtruj według okresu sprawozdawczego wcześniejszego lub równego dacie w formacie YYYY-MM-DD.

  • ticker
    Typ: string

    Symbol tickera spółki. Wymagany, jeśli nie podano cik.

Odpowiedzi
  • 200
    Typ: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

    Historyczne metryki finansowe i wskaźniki dla ticker

    • accession_number
      Typ: string | null

      Numer accession SEC dokumentu.

    • asset_turnover
      Typ: number

      Przychody podzielone przez średnie aktywa ogółem.

    • book_value_growth
      Typ: number

      Wzrost wartości księgowej rok do roku.

    • book_value_per_share
      Typ: number

      Kapitał własny akcjonariuszy podzielony przez akcje w obrocie.

    • cash_ratio
      Typ: number

      Środki pieniężne i ich ekwiwalenty podzielone przez zobowiązania krótkoterminowe.

    • currency
      Typ: string

      Waluta, w której raportowane są dane finansowe.

    • current_ratio
      Typ: number

      Aktywa obrotowe podzielone przez zobowiązania krótkoterminowe.

    • days_sales_outstanding
      Typ: number

      Średnie należności handlowe podzielone przez przychody w danym okresie.

    • debt_to_assets
      Typ: number

      Zadłużenie ogółem podzielone przez aktywa ogółem.

    • debt_to_equity
      Typ: number

      Zadłużenie ogółem podzielone przez kapitał własny akcjonariuszy.

    • earnings_growth
      Typ: number

      Wzrost zysków rok do roku.

    • earnings_per_share
      Typ: number

      Zysk netto podzielony przez średnią ważoną liczbę akcji w obrocie.

    • earnings_per_share_growth
      Typ: number

      Wzrost zysku na akcję w danym okresie.

    • ebitda_growth
      Typ: number

      Wzrost EBITDA w danym okresie.

    • enterprise_value
      Typ: number

      Łączna wartość spółki (kapitalizacja + zadłużenie - gotówka).

    • enterprise_value_to_ebitda_ratio
      Typ: number

      Wskaźnik wartości przedsiębiorstwa do EBITDA.

    • enterprise_value_to_revenue_ratio
      Typ: number

      Wskaźnik wartości przedsiębiorstwa do przychodów.

    • filing_date
      Typ: string | null Format: date

      Dzień kalendarzowy przyjęcia dokumentu przez SEC według czasu wschodniego (strefy operacyjnej SEC). Para dniowa do filing_datetime. Null, gdy z wierszem nie powiązano dokumentu SEC z datą.

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

      Znacznik czasu o rozdzielczości poddziennej rejestrujący przyjęcie dokumentu przez SEC według czasu wschodniego. Źródło: pole acceptanceDateTime SEC w API EDGAR submissions. Stanowi parę z filing_date (dzienną precyzją tego samego zdarzenia).

    • filing_url
      Typ: string | null Format: uri

      URL dokumentu SEC.

    • fiscal_period
      Typ: string

      Okres fiskalny wskaźników finansowych.

    • form_type
      Typ: string | null

      Formularz SEC, z którego pochodzi ten wiersz (10-K, 10-Q/A, 20-F, S-1, ...). Dokładny formularz w postaci złożonej, więc poprawki zachowują przyrostek /A. Null, gdy period ma wartość ttm: okno ostatnich dwunastu miesięcy może obejmować wiele dokumentów, więc nie przypisujemy go do jednego. Wiersz quarterly może zawierać 10-K, gdy czwarty kwartał jest wyliczany z raportu rocznego.

    • free_cash_flow_growth
      Typ: number

      Wzrost wolnych przepływów pieniężnych w danym okresie.

    • free_cash_flow_per_share
      Typ: number

      Wolne przepływy pieniężne podzielone przez akcje w obrocie.

    • free_cash_flow_yield
      Typ: number

      Rentowność wolnych przepływów pieniężnych.

    • gross_margin
      Typ: number

      Zysk brutto jako procent przychodów.

    • interest_coverage
      Typ: number

      EBIT podzielony przez koszty odsetkowe.

    • inventory_turnover
      Typ: number

      Koszt sprzedanych towarów podzielony przez średnie zapasy.

    • net_margin
      Typ: number

      Zysk netto jako procent przychodów.

    • next_page_url
      Typ: string

      Bezwzględny adres URL następnej strony wyników. Obecny tylko wtedy, gdy pozostały dalsze wyniki; aby kontynuować, wyślij żądanie pod ten adres bez zmian. Każda strona zawiera do 10 rekordów.

    • operating_cash_flow_ratio
      Typ: number

      Przepływy pieniężne z działalności operacyjnej podzielone przez zobowiązania krótkoterminowe.

    • operating_cycle
      Typ: number

      Rotacja zapasów + rotacja należności.

    • operating_income_growth
      Typ: number

      Wzrost zysku operacyjnego w danym okresie.

    • operating_margin
      Typ: number

      Zysk operacyjny jako procent przychodów.

    • payout_ratio
      Typ: number

      Dywidendy wypłacone jako procent zysku netto.

    • peg_ratio
      Typ: number

      Wskaźnik ceny do wzrostu zysków.

    • period
      Typ: string enum

      Okres wskaźników finansowych.

      wartości
      • quarterly
      • ttm
      • annual
    • price_to_book_ratio
      Typ: number

      Wskaźnik ceny do wartości księgowej.

    • price_to_earnings_ratio
      Typ: number

      Wskaźnik ceny do zysku.

    • price_to_sales_ratio
      Typ: number

      Wskaźnik ceny do sprzedaży.

    • quick_ratio
      Typ: number

      Aktywa szybko zbywalne podzielone przez zobowiązania krótkoterminowe.

    • receivables_turnover
      Typ: number

      Przychody podzielone przez średnie należności handlowe.

    • report_period
      Typ: string Format: date

      Okres sprawozdawczy wskaźników finansowych.

    • return_on_assets
      Typ: number

      Zysk netto jako procent aktywów ogółem.

    • return_on_equity
      Typ: number

      Zysk netto jako procent kapitału własnego akcjonariuszy.

    • return_on_invested_capital
      Typ: number

      Zysk operacyjny netto po opodatkowaniu jako procent zainwestowanego kapitału.

    • revenue_growth
      Typ: number

      Wzrost przychodów rok do roku.

    • ticker
      Typ: string

      Symbol tickera spółki.

    • working_capital_turnover
      Typ: number

      Przychody podzielone przez średni kapitał obrotowy.

    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

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

Historyczne metryki finansowe i wskaźniki dla ticker

Get financial metrics