Felo API PlatformFelo API Platform
Tüm Financial Data endpoint'leri
v0.2.0-beta
OpenAPI 3.1.0

Kazanç anlık görüntüsünü al

Sunucu:https://openapi.felo.ai
İstemci Kitaplıkları

Financial Data

​

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

Financial Data İşlemler

Kazanç anlık görüntüsünü al

​

Bir hisse için raporlanan kazançlar: gerçekleşen ile tahminler karşılaştırması. Her kayıt report_period, fiscal_period, filing_date, filing_url ve accession_number, revenue, estimated_revenue, revenue_surprise ve revenue_surprise_pct içeren bir quarterly bloğu, earnings_per_share için aynı üçlü ve yıldan yıla değişim alanlarını taşır. Ayrıca signals döndürür: EPS_BEAT gibi upstream tarafından hesaplanan işaretler, bir headline ve arkasındaki actual / estimate / surprise_pct ile. ticker zorunludur ve tek parametredir. Bir şirketin gerçekte ne raporladığı için kullanın. Henüz gerçekleşmemiş ileriye dönük konsensüs için get_financial_analyst_estimates kullanın.

Fiyatlandırma referansı

  • Ölçümlendirme: başarılı istek başına sabit maliyet esası.
  • Referans istek tahmini: USD 0.02.
  • Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

Sorgu Parametreleri
  • cursor
    Tür: string

    Önceki bir yanıtın next_page_url değerinden alınan opak sayfalama imleci. Sağlandığında diğer tüm sorgu parametreleri yok sayılır: imleç, özgün isteğin filtrelerini taşır. Opak olarak değerlendirin; oluşturmayın veya değiştirmeyin.

  • limit
    Tür: integer
    min:  
    1
    maks:  
    40

    Döndürülecek en son rapor dönemlerine ait bildirim sayısı; (report_period DESC, filing_date ASC) düzeninde sıralanır. Son dönemde hem 8-K hem de 10-Q / 10-K varsa döndürülen kayıt sayısı limit değerini aşabilir. 40'ın üzerindeki değerler 40'a sınırlanır. Sıfır veya negatif ya da tam sayı olmayan değerler 400 döndürür. Bu, sayfa boyutu değil tüm sayfaların toplamıdır: her sayfa, next_page_url ile bağlanan en fazla 10 kayıt içerir.

  • ticker
    Tür: string
    gerekli

    Ticker sembolü (ör. AAPL).

Yanıtlar
  • 200
    Tür: object · ResponseE40Feb4D3D6B_EarningsResponse

    Kazanç yanıtı

    • earnings
      Tür: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]

      Ticker için SEC bildirimlerinin düz listesi; (report_period DESC, filing_date ASC) düzeninde sıralanır. limit=N olduğunda en fazla N report_period değerine ait bildirim döndürülür; son dönemde hem 8-K hem de 10-Q/10-K varsa kayıt sayısı N'yi aşabilir.

      • accession_number
        Tür: string
        gerekli

        Bildirimi tanımlayan SEC accession numarası.

      • filing_date
        Tür: string Biçim: date
        gerekli

        SEC'in bildirimi kabul ettiği takvim günü, Doğu Saati'ne göre (SEC'in çalışma saat dilimi). filing_datetime ile takvim günü eşidir.

      • filing_url
        Tür: string Biçim: uri
        gerekli

        SEC bildiriminin URL'si.

      • report_period
        Tür: string Biçim: date
        gerekli

        Bu bildirimin kapsadığı raporlama dönemi.

      • source_type
        Tür: string enum
        gerekli

        Bu bildirimin dayandığı SEC form türü.

        değerler
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        Tür: string
        gerekli

        İstenen ticker sembolü.

      • annual
        Tür: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          Tür: number | null
        • capital_expenditure_chg
          Tür: number

          Sermaye harcamalarında önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • capital_expenditure_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre sermaye harcamalarındaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • cash_and_equivalents
          Tür: number | null
        • change_in_cash_and_equivalents
          Tür: number | null
        • earnings_per_share
          Tür: number | null
        • earnings_per_share_chg
          Tür: number

          EPS'de önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • earnings_per_share_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre EPS'deki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • free_cash_flow
          Tür: number | null
        • free_cash_flow_chg
          Tür: number

          Serbest nakit akışında önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • free_cash_flow_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre serbest nakit akışındaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • gross_margin
          Tür: number

          Brüt marj, ondalık olarak (gross_profit / revenue). Yalnızca hesaplanabildiğinde döndürülür.

        • gross_margin_chg_bps
          Tür: number

          Brüt marjda önceki döneme göre mutlak değişim, baz puan cinsinden (ör. 200.0 = marj 200 bp genişledi). Yalnızca hesaplanabildiğinde döndürülür.

        • gross_margin_chg_pct
          Tür: number

          Brüt marjda önceki döneme göre yüzdelik değişim, ondalık olarak. Yalnızca hesaplanabildiğinde döndürülür.

        • gross_margin_yoy_chg_bps
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre brüt marjdaki yıllık değişim, baz puan cinsinden. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • gross_margin_yoy_chg_pct
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre brüt marjdaki yıllık yüzdelik değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • gross_profit
          Tür: number | null
        • gross_profit_chg
          Tür: number

          Brüt kârda önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • gross_profit_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre brüt kârdaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_financing
          Tür: number | null
        • net_cash_flow_from_financing_chg
          Tür: number

          Finansman faaliyetlerinden net nakit akışında önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_financing_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre finansman faaliyetlerinden net nakit akışındaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_investing
          Tür: number | null
        • net_cash_flow_from_investing_chg
          Tür: number

          Yatırım faaliyetlerinden net nakit akışında önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_investing_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre yatırım faaliyetlerinden net nakit akışındaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_operations
          Tür: number | null
        • net_cash_flow_from_operations_chg
          Tür: number

          İşletme faaliyetlerinden net nakit akışında önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_operations_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre işletme faaliyetlerinden net nakit akışındaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_income
          Tür: number | null
        • net_income_chg
          Tür: number

          Net gelirde önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • net_income_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre net gelirdeki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_margin
          Tür: number

          Net marj, ondalık olarak (net_income / revenue). Yalnızca hesaplanabildiğinde döndürülür.

        • net_margin_chg_bps
          Tür: number

          Net marjda önceki döneme göre mutlak değişim, baz puan cinsinden. Yalnızca hesaplanabildiğinde döndürülür.

        • net_margin_chg_pct
          Tür: number

          Net marjda önceki döneme göre yüzdelik değişim, ondalık olarak. Yalnızca hesaplanabildiğinde döndürülür.

        • net_margin_yoy_chg_bps
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre net marjdaki yıllık değişim, baz puan cinsinden. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_margin_yoy_chg_pct
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre net marjdaki yıllık yüzdelik değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_income
          Tür: number | null
        • operating_income_chg
          Tür: number

          Faaliyet gelirinde önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_income_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre faaliyet gelirindeki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_margin
          Tür: number

          Faaliyet marjı, ondalık olarak (operating_income / revenue). Yalnızca hesaplanabildiğinde döndürülür.

        • operating_margin_chg_bps
          Tür: number

          Faaliyet marjında önceki döneme göre mutlak değişim, baz puan cinsinden. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_margin_chg_pct
          Tür: number

          Faaliyet marjında önceki döneme göre yüzdelik değişim, ondalık olarak. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_margin_yoy_chg_bps
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre faaliyet marjındaki yıllık değişim, baz puan cinsinden. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_margin_yoy_chg_pct
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre faaliyet marjındaki yıllık yüzdelik değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • revenue
          Tür: number | null
        • revenue_chg
          Tür: number

          Gelirde önceki döneme göre yüzdelik değişim, ondalık olarak (ör. 0.10 = +%10). Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • revenue_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre gelirdeki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • shareholders_equity
          Tür: number | null
        • total_assets
          Tür: number | null
        • total_debt
          Tür: number | null
        • total_liabilities
          Tür: number | null
        • weighted_average_shares
          Tür: number | null
        • weighted_average_shares_diluted
          Tür: number | null
      • currency
        Tür: string

        ISO para birimi kodu (ör. USD).

      • filing_datetime
        Tür: string | null Biçim: date-time

        SEC'in bildirimi kabul ettiği anı kaydeden, gün altı çözünürlüklü zaman damgası; Doğu Saati'ne göre. SEC'in EDGAR submissions API'sindeki acceptanceDateTime alanından alınır. filing_date ile eşleşir (aynı olayın takvim günü hassasiyeti).

      • filing_window
        Tür: string | null enum

        SEC'in bildirimi kabul ettiği andaki piyasa oturumu; Doğu Saati'ne göre değerlendirilir. PRE_MARKET = hafta içi 04:00–09:30 ET. DURING_MARKET = hafta içi 09:30–16:00 ET. AFTER_HOURS = hafta içi normal işlem saatleri dışında. WEEKEND = cumartesi veya pazar. filing_datetime yoksa null.

        değerler
        • PRE_MARKET
        • DURING_MARKET
        • AFTER_HOURS
        • WEEKEND
      • fiscal_period
        Tür: string

        Mali dönem etiketi (ör. 2026-Q1 veya 2025-FY).

      • quarterly
        Tür: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          Tür: number | null
        • capital_expenditure_chg
          Tür: number

          Sermaye harcamalarında önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • capital_expenditure_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre sermaye harcamalarındaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • cash_and_equivalents
          Tür: number | null
        • change_in_cash_and_equivalents
          Tür: number | null
        • earnings_per_share
          Tür: number | null
        • earnings_per_share_chg
          Tür: number

          EPS'de önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • earnings_per_share_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre EPS'deki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • free_cash_flow
          Tür: number | null
        • free_cash_flow_chg
          Tür: number

          Serbest nakit akışında önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • free_cash_flow_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre serbest nakit akışındaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • gross_margin
          Tür: number

          Brüt marj, ondalık olarak (gross_profit / revenue). Yalnızca hesaplanabildiğinde döndürülür.

        • gross_margin_chg_bps
          Tür: number

          Brüt marjda önceki döneme göre mutlak değişim, baz puan cinsinden (ör. 200.0 = marj 200 bp genişledi). Yalnızca hesaplanabildiğinde döndürülür.

        • gross_margin_chg_pct
          Tür: number

          Brüt marjda önceki döneme göre yüzdelik değişim, ondalık olarak. Yalnızca hesaplanabildiğinde döndürülür.

        • gross_margin_yoy_chg_bps
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre brüt marjdaki yıllık değişim, baz puan cinsinden. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • gross_margin_yoy_chg_pct
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre brüt marjdaki yıllık yüzdelik değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • gross_profit
          Tür: number | null
        • gross_profit_chg
          Tür: number

          Brüt kârda önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • gross_profit_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre brüt kârdaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_financing
          Tür: number | null
        • net_cash_flow_from_financing_chg
          Tür: number

          Finansman faaliyetlerinden net nakit akışında önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_financing_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre finansman faaliyetlerinden net nakit akışındaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_investing
          Tür: number | null
        • net_cash_flow_from_investing_chg
          Tür: number

          Yatırım faaliyetlerinden net nakit akışında önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_investing_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre yatırım faaliyetlerinden net nakit akışındaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_operations
          Tür: number | null
        • net_cash_flow_from_operations_chg
          Tür: number

          İşletme faaliyetlerinden net nakit akışında önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • net_cash_flow_from_operations_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre işletme faaliyetlerinden net nakit akışındaki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_income
          Tür: number | null
        • net_income_chg
          Tür: number

          Net gelirde önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • net_income_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre net gelirdeki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_margin
          Tür: number

          Net marj, ondalık olarak (net_income / revenue). Yalnızca hesaplanabildiğinde döndürülür.

        • net_margin_chg_bps
          Tür: number

          Net marjda önceki döneme göre mutlak değişim, baz puan cinsinden. Yalnızca hesaplanabildiğinde döndürülür.

        • net_margin_chg_pct
          Tür: number

          Net marjda önceki döneme göre yüzdelik değişim, ondalık olarak. Yalnızca hesaplanabildiğinde döndürülür.

        • net_margin_yoy_chg_bps
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre net marjdaki yıllık değişim, baz puan cinsinden. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • net_margin_yoy_chg_pct
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre net marjdaki yıllık yüzdelik değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_income
          Tür: number | null
        • operating_income_chg
          Tür: number

          Faaliyet gelirinde önceki döneme göre yüzdelik değişim, ondalık olarak. Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_income_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre faaliyet gelirindeki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_margin
          Tür: number

          Faaliyet marjı, ondalık olarak (operating_income / revenue). Yalnızca hesaplanabildiğinde döndürülür.

        • operating_margin_chg_bps
          Tür: number

          Faaliyet marjında önceki döneme göre mutlak değişim, baz puan cinsinden. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_margin_chg_pct
          Tür: number

          Faaliyet marjında önceki döneme göre yüzdelik değişim, ondalık olarak. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_margin_yoy_chg_bps
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre faaliyet marjındaki yıllık değişim, baz puan cinsinden. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • operating_margin_yoy_chg_pct
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre faaliyet marjındaki yıllık yüzdelik değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

        • revenue
          Tür: number | null
        • revenue_chg
          Tür: number

          Gelirde önceki döneme göre yüzdelik değişim, ondalık olarak (ör. 0.10 = +%10). Çeyreklik payload'da önceki döneme göre, yıllık payload'da yıldan yıla. Yalnızca hesaplanabildiğinde döndürülür.

        • revenue_yoy_chg
          Tür: number

          Bir yıl önceki aynı mali çeyreğe göre gelirdeki yıllık değişim, ondalık olarak. Yalnızca çeyreklik payload. Yalnızca hesaplanabildiğinde döndürülür.

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

        Bu bildirimden çıkarılmış, piyasayı hareket ettiren seçilmiş içgörüler. Her öğede önceden işlenmiş bir headline, yapılandırılmış details ve bir importance sıralaması bulunur. Yalnızca bu giriş için en az bir sinyal tetiklendiğinde döndürülür; aksi halde alan atlanır. Giriş başına en fazla 8, HIGH → MEDIUM → LOW sırasıyla.

        Bu bildirimden türetilmiş, piyasayı hareket ettiren seçilmiş bir içgörü. Önceden işlenmiş headline doğrudan görüntülemeye uygundur; details filtreleme ve programatik kullanım için yapılandırılmış alanlar taşır. Sinyaller öncelik sırasıyla döndürülür (en önemli önce); type değeri büyüklüğü kodlar (ör. STRONG_REVENUE_INCREASE ile REVENUE_INCREASE).

        • headline
          Tür: string
          gerekli

          Önceden işlenmiş, doğrudan görüntülemeye uygun, insan tarafından okunabilir özet.

        • type
          Tür: string enum
          gerekli

          Sinyal kategorisi. MARGIN_EXPANSION/MARGIN_CONTRACTION: brüt/faaliyet/net marjların herhangi biri yıldan yıla ≥100 bp hareket etti. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: bildirimde raporlanan ileriye dönük beklenti değişikliği. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: organik gelir büyümesine göre en iyi veya en kötü performans gösteren raporlanabilir segment. NON_GAAP_DIVERGENCE: düzeltilmiş/non-GAAP bir tutar, aynı dönemdeki GAAP karşılığından önemli ölçüde farklı. BACKLOG_SURGE/BACKLOG_DECLINE: iş birikimi veya kalan performans yükümlülükleri yıldan yıla ≥%20 hareket etti. REVENUE_INCREASE/STRONG_REVENUE_INCREASE ve DECLINE varyantları: kademeli yıllık gelir değişimi (≥%10 / ≥%20 büyüklük). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE ve DECLINE varyantları: kademeli yıllık net gelir değişimi (≥%15 / ≥%30). EPS_INCREASE/STRONG_EPS_INCREASE ve DECLINE varyantları: kademeli yıllık EPS değişimi (≥%15 / ≥%30); pay geri alımları EPS hareketini güçlendirebildiği için net gelirden bağımsızdır. CAPEX_INCREASE/STRONG_CAPEX_INCREASE ve DECLINE varyantları: harcama büyüklüğünde kademeli yıllık sermaye harcaması değişimi (≥%15 / ≥%30).

          değerler
          • MARGIN_EXPANSION
          • MARGIN_CONTRACTION
          • GUIDANCE_RAISED
          • GUIDANCE_LOWERED
          • GUIDANCE_REAFFIRMED
        • details
          Tür: object

          Sinyal türüne özgü yapılandırılmış alanlar. İçerik değişir: beklenti sinyalleri low, high, point_estimate, prior_value, revision_pct taşır; segment sinyalleri best, worst, spread_pp taşır; non-GAAP sinyalleri gaap_field, non_gaap_value, gaap_value, divergence_pct taşır; büyüme sinyalleri current, yoy_chg taşır. Null değerler atlanır. Türüne özgü örneklere bakın.

          • propertyName
            Tür: anything
        • metric
          Tür: string | null

          Bu sinyalin başvurduğu metrik, uygulanabildiğinde (ör. revenue, earnings_per_share, operating_margin veya bir beklenti/KPI metrik adı).

        • period
          Tür: string | null

          Sinyalin başvurduğu mali dönem (ör. 2026-Q1, FY 2026). İleriye dönük beklenti sinyalleri beklenen döneme, finansal sinyaller bu bildirimin raporlama dönemine başvurur.

    • next_page_url
      Tür: string

      Sonuçların sonraki sayfasının mutlak URL'si. Yalnızca başka sonuç kaldığında bulunur; devam etmek için olduğu gibi isteyin. Her sayfa en fazla 10 kayıt içerir.

    application/json
  • 400

    İstek işlenemedi. İstek parametrelerini kontrol edin.

  • 401

    Geçerli bir Felo API anahtarı gerekir.

  • 402

    Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.

  • 403

    Hesabın bu işlemi gerçekleştirme izni yok.

  • 429

    İstek veya harcama sınırına ulaşıldı.

  • 502

    Hizmet isteği tamamlayamadı.

  • 503

    API veya faturalandırma hizmeti geçici olarak kullanılamıyor.

  • 504

    İstek işlenirken hizmet zaman aşımına uğradı.

  • default

    Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

    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