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

Pobierz migawkę wyników

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

Financial Data

​

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

Financial Data Operacje

Pobierz migawkę wyników

​

Raportowane wyniki jednej akcji: dane rzeczywiste wobec szacunków. Każdy wpis zawiera report_period, fiscal_period, filing_date, filing_url i accession_number, blok quarterly z revenue, estimated_revenue, revenue_surprise i revenue_surprise_pct, ten sam zestaw trzech pól dla earnings_per_share oraz pola zmiany rok do roku. Zwraca też signals: flagi obliczone upstream, takie jak EPS_BEAT, z headline oraz actual / estimate / surprise_pct stanowiącymi ich podstawę. ticker jest wymagany i jest jedynym parametrem. Używaj go do tego, co firma faktycznie zaraportowała. Do prognozowanego konsensusu, który jeszcze nie nastąpił, użyj get_financial_analyst_estimates.

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

  • limit
    Typ: integer
    min.:  
    1
    maks.:  
    40

    Liczba najnowszych okresów sprawozdawczych, za które mają zostać zwrócone dokumenty, sortowanych według (report_period DESC, filing_date ASC). Liczba zwróconych wpisów może przekroczyć limit, gdy najnowszy okres obejmuje zarówno 8-K, jak i 10-Q / 10-K. Wartości powyżej 40 są ograniczane do 40. Wartości niedodatnie lub niecałkowite zwracają 400. To suma łączna na wszystkich stronach, a nie rozmiar strony: każda strona zawiera do 10 rekordów połączonych przez next_page_url.

  • ticker
    Typ: string
    wymagane

    Symbol tickera (np. AAPL).

Odpowiedzi
  • 200
    Typ: object · ResponseE40Feb4D3D6B_EarningsResponse

    Odpowiedź z wynikami

    • earnings
      Typ: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]

      Płaska lista dokumentów SEC dla tickera, sortowana według (report_period DESC, filing_date ASC). Gdy limit=N, zwracane są dokumenty z maksymalnie N okresów report_period; liczba wpisów może przekroczyć N, gdy najnowszy okres obejmuje zarówno 8-K, jak i 10-Q/10-K.

      • accession_number
        Typ: string
        wymagane

        Numer accession SEC identyfikujący dokument.

      • filing_date
        Typ: string Format: date
        wymagane

        Dzień kalendarzowy przyjęcia dokumentu przez SEC według czasu wschodniego (strefy operacyjnej SEC). Para dniowa do filing_datetime.

      • filing_url
        Typ: string Format: uri
        wymagane

        URL dokumentu SEC.

      • report_period
        Typ: string Format: date
        wymagane

        Okres sprawozdawczy objęty tym dokumentem.

      • source_type
        Typ: string enum
        wymagane

        Typ formularza SEC stanowiący podstawę tego dokumentu.

        wartości
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        Typ: string
        wymagane

        Żądany symbol tickera.

      • annual
        Typ: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          Typ: number | null
        • capital_expenditure_chg
          Typ: number

          Procentowa zmiana nakładów inwestycyjnych względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • capital_expenditure_yoy_chg
          Typ: number

          Zmiana nakładów inwestycyjnych rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • cash_and_equivalents
          Typ: number | null
        • change_in_cash_and_equivalents
          Typ: number | null
        • earnings_per_share
          Typ: number | null
        • earnings_per_share_chg
          Typ: number

          Procentowa zmiana EPS względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • earnings_per_share_yoy_chg
          Typ: number

          Zmiana EPS rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • free_cash_flow
          Typ: number | null
        • free_cash_flow_chg
          Typ: number

          Procentowa zmiana wolnych przepływów pieniężnych względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • free_cash_flow_yoy_chg
          Typ: number

          Zmiana wolnych przepływów pieniężnych rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_margin
          Typ: number

          Marża brutto jako ułamek dziesiętny (gross_profit / revenue). Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_margin_chg_bps
          Typ: number

          Bezwzględna zmiana marży brutto względem poprzedniego okresu w punktach bazowych (np. 200.0 = marża wzrosła o 200 pb). Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_margin_chg_pct
          Typ: number

          Procentowa zmiana marży brutto względem poprzedniego okresu jako ułamek dziesiętny. Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_margin_yoy_chg_bps
          Typ: number

          Zmiana marży brutto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, w punktach bazowych. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_margin_yoy_chg_pct
          Typ: number

          Procentowa zmiana marży brutto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_profit
          Typ: number | null
        • gross_profit_chg
          Typ: number

          Procentowa zmiana zysku brutto względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_profit_yoy_chg
          Typ: number

          Zmiana zysku brutto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_financing
          Typ: number | null
        • net_cash_flow_from_financing_chg
          Typ: number

          Procentowa zmiana przepływów pieniężnych netto z działalności finansowej względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_financing_yoy_chg
          Typ: number

          Zmiana przepływów pieniężnych netto z działalności finansowej rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_investing
          Typ: number | null
        • net_cash_flow_from_investing_chg
          Typ: number

          Procentowa zmiana przepływów pieniężnych netto z działalności inwestycyjnej względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_investing_yoy_chg
          Typ: number

          Zmiana przepływów pieniężnych netto z działalności inwestycyjnej rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_operations
          Typ: number | null
        • net_cash_flow_from_operations_chg
          Typ: number

          Procentowa zmiana przepływów pieniężnych netto z działalności operacyjnej względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_operations_yoy_chg
          Typ: number

          Zmiana przepływów pieniężnych netto z działalności operacyjnej rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_income
          Typ: number | null
        • net_income_chg
          Typ: number

          Procentowa zmiana zysku netto względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_income_yoy_chg
          Typ: number

          Zmiana zysku netto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_margin
          Typ: number

          Marża netto jako ułamek dziesiętny (net_income / revenue). Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_margin_chg_bps
          Typ: number

          Bezwzględna zmiana marży netto względem poprzedniego okresu w punktach bazowych. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_margin_chg_pct
          Typ: number

          Procentowa zmiana marży netto względem poprzedniego okresu jako ułamek dziesiętny. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_margin_yoy_chg_bps
          Typ: number

          Zmiana marży netto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, w punktach bazowych. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_margin_yoy_chg_pct
          Typ: number

          Procentowa zmiana marży netto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_income
          Typ: number | null
        • operating_income_chg
          Typ: number

          Procentowa zmiana zysku operacyjnego względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_income_yoy_chg
          Typ: number

          Zmiana zysku operacyjnego rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_margin
          Typ: number

          Marża operacyjna jako ułamek dziesiętny (operating_income / revenue). Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_margin_chg_bps
          Typ: number

          Bezwzględna zmiana marży operacyjnej względem poprzedniego okresu w punktach bazowych. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_margin_chg_pct
          Typ: number

          Procentowa zmiana marży operacyjnej względem poprzedniego okresu jako ułamek dziesiętny. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_margin_yoy_chg_bps
          Typ: number

          Zmiana marży operacyjnej rok do roku względem tego samego kwartału fiskalnego rok wcześniej, w punktach bazowych. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_margin_yoy_chg_pct
          Typ: number

          Procentowa zmiana marży operacyjnej rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • revenue
          Typ: number | null
        • revenue_chg
          Typ: number

          Procentowa zmiana przychodów względem poprzedniego okresu jako ułamek dziesiętny (np. 0.10 = +10%). W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • revenue_yoy_chg
          Typ: number

          Zmiana przychodów rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • shareholders_equity
          Typ: number | null
        • total_assets
          Typ: number | null
        • total_debt
          Typ: number | null
        • total_liabilities
          Typ: number | null
        • weighted_average_shares
          Typ: number | null
        • weighted_average_shares_diluted
          Typ: number | null
      • currency
        Typ: string

        Kod waluty ISO (np. USD).

      • 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_window
        Typ: string | null enum

        Sesja rynkowa w momencie przyjęcia dokumentu przez SEC, oceniana według czasu wschodniego. PRE_MARKET = dzień roboczy 04:00–09:30 ET. DURING_MARKET = dzień roboczy 09:30–16:00 ET. AFTER_HOURS = dzień roboczy poza regularnymi godzinami handlu. WEEKEND = sobota lub niedziela. Null, gdy filing_datetime jest niedostępny.

        wartości
        • PRE_MARKET
        • DURING_MARKET
        • AFTER_HOURS
        • WEEKEND
      • fiscal_period
        Typ: string

        Etykieta okresu fiskalnego (np. 2026-Q1 lub 2025-FY).

      • quarterly
        Typ: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          Typ: number | null
        • capital_expenditure_chg
          Typ: number

          Procentowa zmiana nakładów inwestycyjnych względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • capital_expenditure_yoy_chg
          Typ: number

          Zmiana nakładów inwestycyjnych rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • cash_and_equivalents
          Typ: number | null
        • change_in_cash_and_equivalents
          Typ: number | null
        • earnings_per_share
          Typ: number | null
        • earnings_per_share_chg
          Typ: number

          Procentowa zmiana EPS względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • earnings_per_share_yoy_chg
          Typ: number

          Zmiana EPS rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • free_cash_flow
          Typ: number | null
        • free_cash_flow_chg
          Typ: number

          Procentowa zmiana wolnych przepływów pieniężnych względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • free_cash_flow_yoy_chg
          Typ: number

          Zmiana wolnych przepływów pieniężnych rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_margin
          Typ: number

          Marża brutto jako ułamek dziesiętny (gross_profit / revenue). Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_margin_chg_bps
          Typ: number

          Bezwzględna zmiana marży brutto względem poprzedniego okresu w punktach bazowych (np. 200.0 = marża wzrosła o 200 pb). Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_margin_chg_pct
          Typ: number

          Procentowa zmiana marży brutto względem poprzedniego okresu jako ułamek dziesiętny. Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_margin_yoy_chg_bps
          Typ: number

          Zmiana marży brutto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, w punktach bazowych. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_margin_yoy_chg_pct
          Typ: number

          Procentowa zmiana marży brutto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_profit
          Typ: number | null
        • gross_profit_chg
          Typ: number

          Procentowa zmiana zysku brutto względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • gross_profit_yoy_chg
          Typ: number

          Zmiana zysku brutto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_financing
          Typ: number | null
        • net_cash_flow_from_financing_chg
          Typ: number

          Procentowa zmiana przepływów pieniężnych netto z działalności finansowej względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_financing_yoy_chg
          Typ: number

          Zmiana przepływów pieniężnych netto z działalności finansowej rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_investing
          Typ: number | null
        • net_cash_flow_from_investing_chg
          Typ: number

          Procentowa zmiana przepływów pieniężnych netto z działalności inwestycyjnej względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_investing_yoy_chg
          Typ: number

          Zmiana przepływów pieniężnych netto z działalności inwestycyjnej rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_operations
          Typ: number | null
        • net_cash_flow_from_operations_chg
          Typ: number

          Procentowa zmiana przepływów pieniężnych netto z działalności operacyjnej względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_cash_flow_from_operations_yoy_chg
          Typ: number

          Zmiana przepływów pieniężnych netto z działalności operacyjnej rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_income
          Typ: number | null
        • net_income_chg
          Typ: number

          Procentowa zmiana zysku netto względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_income_yoy_chg
          Typ: number

          Zmiana zysku netto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_margin
          Typ: number

          Marża netto jako ułamek dziesiętny (net_income / revenue). Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_margin_chg_bps
          Typ: number

          Bezwzględna zmiana marży netto względem poprzedniego okresu w punktach bazowych. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_margin_chg_pct
          Typ: number

          Procentowa zmiana marży netto względem poprzedniego okresu jako ułamek dziesiętny. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_margin_yoy_chg_bps
          Typ: number

          Zmiana marży netto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, w punktach bazowych. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • net_margin_yoy_chg_pct
          Typ: number

          Procentowa zmiana marży netto rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_income
          Typ: number | null
        • operating_income_chg
          Typ: number

          Procentowa zmiana zysku operacyjnego względem poprzedniego okresu jako ułamek dziesiętny. W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_income_yoy_chg
          Typ: number

          Zmiana zysku operacyjnego rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_margin
          Typ: number

          Marża operacyjna jako ułamek dziesiętny (operating_income / revenue). Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_margin_chg_bps
          Typ: number

          Bezwzględna zmiana marży operacyjnej względem poprzedniego okresu w punktach bazowych. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_margin_chg_pct
          Typ: number

          Procentowa zmiana marży operacyjnej względem poprzedniego okresu jako ułamek dziesiętny. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_margin_yoy_chg_bps
          Typ: number

          Zmiana marży operacyjnej rok do roku względem tego samego kwartału fiskalnego rok wcześniej, w punktach bazowych. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • operating_margin_yoy_chg_pct
          Typ: number

          Procentowa zmiana marży operacyjnej rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • revenue
          Typ: number | null
        • revenue_chg
          Typ: number

          Procentowa zmiana przychodów względem poprzedniego okresu jako ułamek dziesiętny (np. 0.10 = +10%). W danych kwartalnych zmiana sekwencyjna, w danych rocznych rok do roku. Zwracana tylko wtedy, gdy można ją obliczyć.

        • revenue_yoy_chg
          Typ: number

          Zmiana przychodów rok do roku względem tego samego kwartału fiskalnego rok wcześniej, jako ułamek dziesiętny. Tylko dane kwartalne. Zwracana tylko wtedy, gdy można ją obliczyć.

        • shareholders_equity
          Typ: number | null
        • total_assets
          Typ: number | null
        • total_debt
          Typ: number | null
        • total_liabilities
          Typ: number | null
        • weighted_average_shares
          Typ: number | null
        • weighted_average_shares_diluted
          Typ: number | null
      • signals
        Typ: array object[] · ResponseE40Feb4D3D6B_Signal[]

        Wyselekcjonowane wnioski wpływające na rynek, wyodrębnione z tego dokumentu. Każda pozycja ma wstępnie wyrenderowany headline, ustrukturyzowane details i ranking importance. Zwracane tylko wtedy, gdy dla tego wpisu zostanie wyzwolony co najmniej jeden sygnał; w przeciwnym razie pole jest pomijane. Maksymalnie 8 na wpis, w kolejności HIGH → MEDIUM → LOW.

        Wyselekcjonowany wniosek wpływający na rynek, wyprowadzony z tego dokumentu. Wstępnie wyrenderowany headline nadaje się do bezpośredniego wyświetlenia; details zawiera ustrukturyzowane pola do filtrowania i użycia programistycznego. Sygnały są zwracane w kolejności priorytetu (najistotniejsze najpierw); samo type koduje skalę (np. STRONG_REVENUE_INCREASE vs REVENUE_INCREASE).

        • headline
          Typ: string
          wymagane

          Wstępnie wyrenderowane, czytelne dla człowieka podsumowanie odpowiednie do bezpośredniego wyświetlenia.

        • type
          Typ: string enum
          wymagane

          Kategoria sygnału. MARGIN_EXPANSION/MARGIN_CONTRACTION: dowolna z marż — brutto, operacyjna lub netto — zmieniła się rok do roku o ≥100 pb. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: zmiana prognoz przyszłych wyników zgłoszona w dokumencie. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: najlepiej lub najgorzej wypadający segment sprawozdawczy według wzrostu przychodów organicznych. NON_GAAP_DIVERGENCE: wartość skorygowana/non-GAAP istotnie różni się od swojego odpowiednika GAAP w tym samym okresie. BACKLOG_SURGE/BACKLOG_DECLINE: portfel zamówień lub pozostałe zobowiązania wykonawcze zmieniły się rok do roku o ≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE oraz warianty DECLINE: progowa zmiana przychodów rok do roku (≥10% / ≥20% skali). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE oraz warianty DECLINE: progowa zmiana zysku netto rok do roku (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE oraz warianty DECLINE: progowa zmiana EPS rok do roku (≥15% / ≥30%); niezależna od zysku netto, ponieważ skup akcji własnych może wzmacniać ruch EPS. CAPEX_INCREASE/STRONG_CAPEX_INCREASE oraz warianty DECLINE: progowa zmiana nakładów inwestycyjnych rok do roku pod względem wielkości wydatków (≥15% / ≥30%).

          wartości
          • MARGIN_EXPANSION
          • MARGIN_CONTRACTION
          • GUIDANCE_RAISED
          • GUIDANCE_LOWERED
          • GUIDANCE_REAFFIRMED
        • details
          Typ: object

          Pola ustrukturyzowane specyficzne dla typu sygnału. Zawartość jest zmienna: sygnały prognoz zawierają low, high, point_estimate, prior_value, revision_pct; sygnały segmentowe zawierają best, worst, spread_pp; sygnały non-GAAP zawierają gaap_field, non_gaap_value, gaap_value, divergence_pct; sygnały wzrostu zawierają current, yoy_chg. Wartości null są pomijane. Zobacz przykłady dla poszczególnych typów.

          • propertyName
            Typ: anything
        • metric
          Typ: string | null

          Wskaźnik, do którego odwołuje się ten sygnał, jeśli ma zastosowanie (np. revenue, earnings_per_share, operating_margin lub nazwa wskaźnika prognozy/KPI).

        • period
          Typ: string | null

          Okres fiskalny, do którego odwołuje się sygnał (np. 2026-Q1, FY 2026). Sygnały prognoz odwołują się do prognozowanego okresu; sygnały finansowe — do okresu sprawozdawczego tego dokumentu.

    • 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/earnings
curl 'https://openapi.felo.ai/v1/beta/financial/earnings?ticker=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "earnings": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "fiscal_period": "string",
      "currency": "string",
      "source_type": "8-K",
      "filing_date": "2026-10-26",
      "filing_datetime": null,
      "filing_window": "PRE_MARKET",
      "signals": [
        {
          "type": "MARGIN_EXPANSION",
          "metric": null,
          "period": null,
          "headline": "string",
          "details": {
            "additionalProperty": "anything"
          }
        }
      ],
      "filing_url": "https://example.com",
      "accession_number": "string",
      "quarterly": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      },
      "annual": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      }
    }
  ],
  "next_page_url": "string"
}
Get earnings snapshot