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

Pobierz wszystkie sprawozdania finansowe

Serwer:https://openapi.felo.ai
Biblioteki klienckie

Financial Data

​

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

Financial Data Operacje

Pobierz wszystkie sprawozdania finansowe

​

Wszystkie trzy sprawozdania jednej spółki w jednym wywołaniu. Zwraca obiekt financials zawierający income_statements, balance_sheets i cash_flow_statements, każdy w tym samym kształcie, jaki zwracają dedykowane narzędzia. period jest wymagane (annual, quarterly lub ttm); zidentyfikuj spółkę przez ticker lub cik i ogranicz liczbę przez limit. Używaj go, gdy potrzebujesz pełnego obrazu, a w przeciwnym razie wykonałbyś trzy wywołania. Gdy potrzebujesz tylko jednego sprawozdania, get_financial_financials_income_statements, get_financial_financials_balance_sheets lub get_financial_financials_cash_flow_statements zwraca znacznie mniej danych; gdy potrzebujesz kilku nazwanych pól w kilku spółkach, post_financial_financials_search_line_items jest jeszcze węższe.

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.

  • 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 Format: int32

    Maksymalna liczba sprawozdań finansowych 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 sprawozdań 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. Wymagany, jeśli nie podano cik.

Odpowiedzi
  • 200
    Typ: object · ResponseE40Feb4D3D6B_FinancialsResponse

    Odpowiedź ze sprawozdaniami finansowymi

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

          Numer accession SEC dokumentu.

        • accumulated_other_comprehensive_income
          Typ: number

          Skumulowane pozostałe dochody całkowite spółki.

        • cash_and_equivalents
          Typ: number

          Środki pieniężne i ich ekwiwalenty spółki.

        • currency
          Typ: string

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

        • current_assets
          Typ: number

          Aktywa obrotowe spółki.

        • current_debt
          Typ: number

          Zadłużenie krótkoterminowe spółki.

        • current_investments
          Typ: number

          Inwestycje krótkoterminowe spółki.

        • current_liabilities
          Typ: number

          Zobowiązania krótkoterminowe spółki.

        • deferred_revenue
          Typ: number

          Przychody przyszłych okresów spółki.

        • deposit_liabilities
          Typ: number

          Zobowiązania z tytułu depozytów spółki.

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

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

        • goodwill_and_intangible_assets
          Typ: number

          Wartość firmy i aktywa niematerialne spółki.

        • inventory
          Typ: number

          Zapasy spółki.

        • investments
          Typ: number

          Inwestycje spółki.

        • non_current_assets
          Typ: number

          Aktywa trwałe spółki.

        • non_current_debt
          Typ: number

          Zadłużenie długoterminowe spółki.

        • non_current_investments
          Typ: number

          Inwestycje długoterminowe spółki.

        • non_current_liabilities
          Typ: number

          Zobowiązania długoterminowe spółki.

        • outstanding_shares
          Typ: number

          Akcje w obrocie spółki.

        • period
          Typ: string enum

          Okres bilansu.

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

          Rzeczowe aktywa trwałe spółki.

        • report_period
          Typ: string Format: date

          Okres sprawozdawczy bilansu.

        • retained_earnings
          Typ: number

          Zyski zatrzymane spółki.

        • shareholders_equity
          Typ: number

          Kapitał własny akcjonariuszy spółki.

        • tax_assets
          Typ: number

          Aktywa z tytułu podatku spółki.

        • tax_liabilities
          Typ: number

          Zobowiązania z tytułu podatku spółki.

        • ticker
          Typ: string

          Symbol tickera.

        • total_assets
          Typ: number

          Aktywa ogółem spółki.

        • total_debt
          Typ: number

          Zadłużenie ogółem spółki.

        • total_liabilities
          Typ: number

          Zobowiązania ogółem spółki.

        • trade_and_non_trade_payables
          Typ: number

          Zobowiązania handlowe i pozahandlowe spółki.

        • trade_and_non_trade_receivables
          Typ: number

          Należności handlowe i pozahandlowe spółki.

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

          Numer accession SEC dokumentu.

        • business_acquisitions_and_disposals
          Typ: number

          Przejęcia i zbycia działalności spółki.

        • capital_expenditure
          Typ: number

          Nakłady inwestycyjne spółki.

        • change_in_cash_and_equivalents
          Typ: number

          Zmiana środków pieniężnych i ich ekwiwalentów spółki.

        • currency
          Typ: string

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

        • depreciation_and_amortization
          Typ: number

          Amortyzacja spółki.

        • dividends_and_other_cash_distributions
          Typ: number

          Dywidendy i inne wypłaty środków pieniężnych spółki.

        • effect_of_exchange_rate_changes
          Typ: number

          Wpływ zmian kursów walutowych spółki.

        • ending_cash_balance
          Typ: number

          Końcowe saldo środków pieniężnych spółki.

        • 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 rachunku przepływów pieniężnych.

        • 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
          Typ: number

          Wolne przepływy pieniężne spółki.

        • investment_acquisitions_and_disposals
          Typ: number

          Nabycia i zbycia inwestycji spółki.

        • issuance_or_purchase_of_equity_shares
          Typ: number

          Emisja lub nabycie akcji własnych spółki.

        • issuance_or_repayment_of_debt_securities
          Typ: number

          Emisja lub spłata papierów dłużnych spółki.

        • net_cash_flow_from_financing
          Typ: number

          Przepływy pieniężne netto z działalności finansowej spółki.

        • net_cash_flow_from_investing
          Typ: number

          Przepływy pieniężne netto z działalności inwestycyjnej spółki.

        • net_cash_flow_from_operations
          Typ: number

          Przepływy pieniężne netto z działalności operacyjnej spółki.

        • net_income
          Typ: number

          Zysk netto spółki.

        • period
          Typ: string enum

          Okres rachunku przepływów pieniężnych.

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

          Okres sprawozdawczy rachunku przepływów pieniężnych.

        • share_based_compensation
          Typ: number

          Wynagrodzenie w formie akcji spółki.

        • ticker
          Typ: string

          Symbol tickera.

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

          Numer accession SEC dokumentu.

        • consolidated_income
          Typ: number

          Skonsolidowany dochód spółki.

        • cost_of_revenue
          Typ: number

          Koszt przychodów spółki.

        • currency
          Typ: string

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

        • dividends_per_common_share
          Typ: number

          Dywidendy na jedną akcję zwykłą spółki.

        • earnings_per_share
          Typ: number

          Zysk na akcję spółki.

        • earnings_per_share_diluted
          Typ: number

          Rozwodniony zysk na akcję spółki.

        • ebit
          Typ: number

          Zysk przed odsetkami i podatkami spółki.

        • 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 rachunku wyników.

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

        • gross_profit
          Typ: number

          Zysk brutto spółki.

        • income_tax_expense
          Typ: number

          Koszty podatku dochodowego spółki.

        • interest_expense
          Typ: number

          Koszty odsetkowe spółki.

        • net_income
          Typ: number

          Zysk netto spółki.

        • net_income_common_stock
          Typ: number

          Zysk netto dostępny dla akcjonariuszy zwykłych spółki.

        • net_income_discontinued_operations
          Typ: number

          Zysk netto z działalności zaniechanej spółki.

        • net_income_non_controlling_interests
          Typ: number

          Zysk netto z udziałów niekontrolujących spółki.

        • operating_expense
          Typ: number

          Koszty operacyjne spółki.

        • operating_income
          Typ: number

          Zysk operacyjny spółki.

        • period
          Typ: string enum

          Okres rachunku wyników.

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

          Wpływ dywidend uprzywilejowanych na zysk netto spółki.

        • report_period
          Typ: string Format: date

          Okres sprawozdawczy rachunku wyników.

        • research_and_development
          Typ: number

          Koszty badań i rozwoju spółki.

        • revenue
          Typ: number

          Przychody ogółem spółki.

        • selling_general_and_administrative_expenses
          Typ: number

          Koszty sprzedaży, ogólne i administracyjne spółki.

        • ticker
          Typ: string

          Symbol tickera.

        • weighted_average_shares
          Typ: number

          Średnia ważona liczba akcji spółki.

        • weighted_average_shares_diluted
          Typ: number

          Rozwodniona średnia ważona liczba akcji spółki.

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

    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/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