Felo API PlatformFelo API Platform
Semua endpoint Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Dapatkan petikan pendapatan

Pelayan:https://openapi.felo.ai
Pustaka Klien

Financial Data

​

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

Financial Data Operasi

Dapatkan petikan pendapatan

​

Pendapatan yang dilaporkan bagi satu saham, angka sebenar berbanding anggaran. Setiap entri membawa report_period, fiscal_period, filing_date, filing_url dan accession_number, blok quarterly dengan revenue, estimated_revenue, revenue_surprise dan revenue_surprise_pct, trio yang sama untuk earnings_per_share, serta medan perubahan tahun ke tahun. Ia juga memulangkan signals: bendera yang dikira upstream seperti EPS_BEAT dengan headline serta actual / estimate / surprise_pct di sebaliknya. ticker diperlukan dan merupakan satu-satunya parameter. Gunakan untuk apa yang benar-benar dilaporkan syarikat. Untuk konsensus ramalan yang belum berlaku, gunakan get_financial_analyst_estimates.

Rujukan harga

  • Pemeteran: Asas kos tetap bagi setiap permintaan berjaya.
  • Anggaran rujukan setiap permintaan: USD 0.02.
  • Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Parameter Pertanyaan
  • cursor
    Jenis: string

    Kursor penomboran legap daripada next_page_url respons sebelumnya. Apabila diberikan, semua parameter pertanyaan lain diabaikan: kursor membawa penapis permintaan asal. Anggap ia legap; jangan bina atau ubah suainya.

  • limit
    Jenis: integer
    min:  
    1
    maks:  
    40

    Bilangan tempoh laporan terkini yang pemfailannya akan dipulangkan, disusun mengikut (report_period DESC, filing_date ASC). Bilangan entri yang dipulangkan mungkin melebihi limit apabila tempoh terkini mempunyai kedua-dua 8-K dan 10-Q / 10-K. Nilai melebihi 40 dihadkan kepada 40. Nilai bukan positif atau bukan integer memulangkan 400. Ini ialah jumlah merentas semua halaman, bukan saiz halaman: setiap halaman memuatkan sehingga 10 rekod, dipautkan oleh next_page_url.

  • ticker
    Jenis: string
    wajib

    Simbol ticker (cth. AAPL).

Respons
  • 200
    Jenis: object · ResponseE40Feb4D3D6B_EarningsResponse

    Respons pendapatan

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

      Senarai rata pemfailan SEC untuk ticker, disusun mengikut (report_period DESC, filing_date ASC). Apabila limit=N, sehingga N report_period pemfailan dipulangkan; bilangan entri boleh melebihi N apabila tempoh terkini mempunyai kedua-dua 8-K dan 10-Q/10-K.

      • accession_number
        Jenis: string
        wajib

        Nombor aksesi SEC yang mengenal pasti pemfailan.

      • filing_date
        Jenis: string Format: date
        wajib

        Hari kalendar SEC menerima pemfailan, dalam Waktu Timur (zon waktu operasi SEC). Pasangan hari kalendar untuk filing_datetime.

      • filing_url
        Jenis: string Format: uri
        wajib

        URL ke pemfailan SEC.

      • report_period
        Jenis: string Format: date
        wajib

        Tempoh laporan yang diliputi pemfailan ini.

      • source_type
        Jenis: string enum
        wajib

        Jenis borang SEC yang mendasari pemfailan ini.

        nilai
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        Jenis: string
        wajib

        Simbol ticker yang diminta.

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

          Peratus perubahan perbelanjaan modal berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • capital_expenditure_yoy_chg
          Jenis: number

          Perubahan perbelanjaan modal berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

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

          Peratus perubahan EPS berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • earnings_per_share_yoy_chg
          Jenis: number

          Perubahan EPS berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • free_cash_flow
          Jenis: number | null
        • free_cash_flow_chg
          Jenis: number

          Peratus perubahan aliran tunai bebas berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • free_cash_flow_yoy_chg
          Jenis: number

          Perubahan aliran tunai bebas berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • gross_margin
          Jenis: number

          Margin untung kasar sebagai perpuluhan (gross_profit / revenue). Hanya dipulangkan apabila boleh dikira.

        • gross_margin_chg_bps
          Jenis: number

          Perubahan mutlak margin untung kasar berbanding tempoh sebelumnya dalam mata asas (contohnya 200.0 = margin melebar 200 bps). Hanya dipulangkan apabila boleh dikira.

        • gross_margin_chg_pct
          Jenis: number

          Peratus perubahan margin untung kasar berbanding tempoh sebelumnya sebagai perpuluhan. Hanya dipulangkan apabila boleh dikira.

        • gross_margin_yoy_chg_bps
          Jenis: number

          Perubahan margin untung kasar berbanding suku fiskal yang sama setahun sebelumnya, dalam mata asas. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • gross_margin_yoy_chg_pct
          Jenis: number

          Peratus perubahan margin untung kasar berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • gross_profit
          Jenis: number | null
        • gross_profit_chg
          Jenis: number

          Peratus perubahan untung kasar berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • gross_profit_yoy_chg
          Jenis: number

          Perubahan untung kasar berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_financing
          Jenis: number | null
        • net_cash_flow_from_financing_chg
          Jenis: number

          Peratus perubahan aliran tunai bersih daripada pembiayaan berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_financing_yoy_chg
          Jenis: number

          Perubahan aliran tunai bersih daripada pembiayaan berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_investing
          Jenis: number | null
        • net_cash_flow_from_investing_chg
          Jenis: number

          Peratus perubahan aliran tunai bersih daripada pelaburan berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_investing_yoy_chg
          Jenis: number

          Perubahan aliran tunai bersih daripada pelaburan berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_operations
          Jenis: number | null
        • net_cash_flow_from_operations_chg
          Jenis: number

          Peratus perubahan aliran tunai bersih daripada operasi berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_operations_yoy_chg
          Jenis: number

          Perubahan aliran tunai bersih daripada operasi berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_income
          Jenis: number | null
        • net_income_chg
          Jenis: number

          Peratus perubahan pendapatan bersih berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • net_income_yoy_chg
          Jenis: number

          Perubahan pendapatan bersih berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_margin
          Jenis: number

          Margin bersih sebagai perpuluhan (net_income / revenue). Hanya dipulangkan apabila boleh dikira.

        • net_margin_chg_bps
          Jenis: number

          Perubahan mutlak margin bersih berbanding tempoh sebelumnya dalam mata asas. Hanya dipulangkan apabila boleh dikira.

        • net_margin_chg_pct
          Jenis: number

          Peratus perubahan margin bersih berbanding tempoh sebelumnya sebagai perpuluhan. Hanya dipulangkan apabila boleh dikira.

        • net_margin_yoy_chg_bps
          Jenis: number

          Perubahan margin bersih berbanding suku fiskal yang sama setahun sebelumnya, dalam mata asas. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_margin_yoy_chg_pct
          Jenis: number

          Peratus perubahan margin bersih berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • operating_income
          Jenis: number | null
        • operating_income_chg
          Jenis: number

          Peratus perubahan pendapatan operasi berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • operating_income_yoy_chg
          Jenis: number

          Perubahan pendapatan operasi berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • operating_margin
          Jenis: number

          Margin operasi sebagai perpuluhan (operating_income / revenue). Hanya dipulangkan apabila boleh dikira.

        • operating_margin_chg_bps
          Jenis: number

          Perubahan mutlak margin operasi berbanding tempoh sebelumnya dalam mata asas. Hanya dipulangkan apabila boleh dikira.

        • operating_margin_chg_pct
          Jenis: number

          Peratus perubahan margin operasi berbanding tempoh sebelumnya sebagai perpuluhan. Hanya dipulangkan apabila boleh dikira.

        • operating_margin_yoy_chg_bps
          Jenis: number

          Perubahan margin operasi berbanding suku fiskal yang sama setahun sebelumnya, dalam mata asas. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • operating_margin_yoy_chg_pct
          Jenis: number

          Peratus perubahan margin operasi berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • revenue
          Jenis: number | null
        • revenue_chg
          Jenis: number

          Peratus perubahan hasil berbanding tempoh sebelumnya sebagai perpuluhan (contohnya 0.10 = +10%). Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • revenue_yoy_chg
          Jenis: number

          Perubahan hasil berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

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

        Kod mata wang ISO (contohnya USD).

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

        Cap masa sub-hari yang merekodkan apabila SEC menerima pemfailan, dalam Waktu Timur. Bersumber daripada medan acceptanceDateTime SEC pada API submissions EDGAR. Berpasangan dengan filing_date (ketepatan hari kalendar bagi peristiwa yang sama).

      • filing_window
        Jenis: string | null enum

        Sesi pasaran pada saat SEC menerima pemfailan, dinilai dalam Waktu Timur. PRE_MARKET = hari bekerja 04:00–09:30 ET. DURING_MARKET = hari bekerja 09:30–16:00 ET. AFTER_HOURS = hari bekerja di luar waktu dagangan biasa. WEEKEND = Sabtu atau Ahad. Null apabila filing_datetime tidak tersedia.

        nilai
        • PRE_MARKET
        • DURING_MARKET
        • AFTER_HOURS
        • WEEKEND
      • fiscal_period
        Jenis: string

        Label tempoh fiskal (contohnya 2026-Q1 atau 2025-FY).

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

          Peratus perubahan perbelanjaan modal berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • capital_expenditure_yoy_chg
          Jenis: number

          Perubahan perbelanjaan modal berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

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

          Peratus perubahan EPS berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • earnings_per_share_yoy_chg
          Jenis: number

          Perubahan EPS berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • free_cash_flow
          Jenis: number | null
        • free_cash_flow_chg
          Jenis: number

          Peratus perubahan aliran tunai bebas berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • free_cash_flow_yoy_chg
          Jenis: number

          Perubahan aliran tunai bebas berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • gross_margin
          Jenis: number

          Margin untung kasar sebagai perpuluhan (gross_profit / revenue). Hanya dipulangkan apabila boleh dikira.

        • gross_margin_chg_bps
          Jenis: number

          Perubahan mutlak margin untung kasar berbanding tempoh sebelumnya dalam mata asas (contohnya 200.0 = margin melebar 200 bps). Hanya dipulangkan apabila boleh dikira.

        • gross_margin_chg_pct
          Jenis: number

          Peratus perubahan margin untung kasar berbanding tempoh sebelumnya sebagai perpuluhan. Hanya dipulangkan apabila boleh dikira.

        • gross_margin_yoy_chg_bps
          Jenis: number

          Perubahan margin untung kasar berbanding suku fiskal yang sama setahun sebelumnya, dalam mata asas. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • gross_margin_yoy_chg_pct
          Jenis: number

          Peratus perubahan margin untung kasar berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • gross_profit
          Jenis: number | null
        • gross_profit_chg
          Jenis: number

          Peratus perubahan untung kasar berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • gross_profit_yoy_chg
          Jenis: number

          Perubahan untung kasar berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_financing
          Jenis: number | null
        • net_cash_flow_from_financing_chg
          Jenis: number

          Peratus perubahan aliran tunai bersih daripada pembiayaan berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_financing_yoy_chg
          Jenis: number

          Perubahan aliran tunai bersih daripada pembiayaan berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_investing
          Jenis: number | null
        • net_cash_flow_from_investing_chg
          Jenis: number

          Peratus perubahan aliran tunai bersih daripada pelaburan berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_investing_yoy_chg
          Jenis: number

          Perubahan aliran tunai bersih daripada pelaburan berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_operations
          Jenis: number | null
        • net_cash_flow_from_operations_chg
          Jenis: number

          Peratus perubahan aliran tunai bersih daripada operasi berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • net_cash_flow_from_operations_yoy_chg
          Jenis: number

          Perubahan aliran tunai bersih daripada operasi berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_income
          Jenis: number | null
        • net_income_chg
          Jenis: number

          Peratus perubahan pendapatan bersih berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • net_income_yoy_chg
          Jenis: number

          Perubahan pendapatan bersih berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_margin
          Jenis: number

          Margin bersih sebagai perpuluhan (net_income / revenue). Hanya dipulangkan apabila boleh dikira.

        • net_margin_chg_bps
          Jenis: number

          Perubahan mutlak margin bersih berbanding tempoh sebelumnya dalam mata asas. Hanya dipulangkan apabila boleh dikira.

        • net_margin_chg_pct
          Jenis: number

          Peratus perubahan margin bersih berbanding tempoh sebelumnya sebagai perpuluhan. Hanya dipulangkan apabila boleh dikira.

        • net_margin_yoy_chg_bps
          Jenis: number

          Perubahan margin bersih berbanding suku fiskal yang sama setahun sebelumnya, dalam mata asas. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • net_margin_yoy_chg_pct
          Jenis: number

          Peratus perubahan margin bersih berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • operating_income
          Jenis: number | null
        • operating_income_chg
          Jenis: number

          Peratus perubahan pendapatan operasi berbanding tempoh sebelumnya sebagai perpuluhan. Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • operating_income_yoy_chg
          Jenis: number

          Perubahan pendapatan operasi berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • operating_margin
          Jenis: number

          Margin operasi sebagai perpuluhan (operating_income / revenue). Hanya dipulangkan apabila boleh dikira.

        • operating_margin_chg_bps
          Jenis: number

          Perubahan mutlak margin operasi berbanding tempoh sebelumnya dalam mata asas. Hanya dipulangkan apabila boleh dikira.

        • operating_margin_chg_pct
          Jenis: number

          Peratus perubahan margin operasi berbanding tempoh sebelumnya sebagai perpuluhan. Hanya dipulangkan apabila boleh dikira.

        • operating_margin_yoy_chg_bps
          Jenis: number

          Perubahan margin operasi berbanding suku fiskal yang sama setahun sebelumnya, dalam mata asas. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • operating_margin_yoy_chg_pct
          Jenis: number

          Peratus perubahan margin operasi berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

        • revenue
          Jenis: number | null
        • revenue_chg
          Jenis: number

          Peratus perubahan hasil berbanding tempoh sebelumnya sebagai perpuluhan (contohnya 0.10 = +10%). Berturutan dalam payload suku tahunan, tahun ke tahun dalam payload tahunan. Hanya dipulangkan apabila boleh dikira.

        • revenue_yoy_chg
          Jenis: number

          Perubahan hasil berbanding suku fiskal yang sama setahun sebelumnya, sebagai perpuluhan. Payload suku tahunan sahaja. Hanya dipulangkan apabila boleh dikira.

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

        Cerapan terkurasi yang berpotensi menggerakkan pasaran, disaring daripada pemfailan ini. Setiap item mempunyai headline yang telah dirender, details berstruktur dan kedudukan importance. Hanya dipulangkan apabila sekurang-kurangnya satu isyarat dicetuskan untuk entri ini; jika tidak, medan ditiadakan. Terhad kepada 8 setiap entri, disusun HIGH → MEDIUM → LOW.

        Cerapan terkurasi yang berpotensi menggerakkan pasaran yang diperoleh daripada pemfailan ini. headline yang telah dirender sesuai untuk paparan langsung; details membawa medan berstruktur untuk penapisan dan penggunaan programatik. Isyarat dipulangkan mengikut susunan keutamaan (paling material dahulu); type itu sendiri mengekod magnitud (contohnya STRONG_REVENUE_INCREASE berbanding REVENUE_INCREASE).

        • headline
          Jenis: string
          wajib

          Ringkasan mudah dibaca yang telah dirender, sesuai untuk paparan langsung.

        • type
          Jenis: string enum
          wajib

          Kategori isyarat. MARGIN_EXPANSION/MARGIN_CONTRACTION: mana-mana margin kasar/operasi/bersih bergerak tahun ke tahun sebanyak ≥100bps. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: perubahan panduan berwawasan ke hadapan yang dilaporkan dalam pemfailan. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: segmen boleh lapor dengan prestasi terbaik atau terburuk mengikut pertumbuhan hasil organik. NON_GAAP_DIVERGENCE: angka diselaraskan/bukan GAAP berbeza secara material daripada rakan GAAP-nya pada tempoh yang sama. BACKLOG_SURGE/BACKLOG_DECLINE: backlog atau obligasi prestasi selebihnya bergerak tahun ke tahun sebanyak ≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE dan varian DECLINE: perubahan hasil tahun ke tahun bertingkat (magnitud ≥10% / ≥20%). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE dan varian DECLINE: perubahan pendapatan bersih tahun ke tahun bertingkat (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE dan varian DECLINE: perubahan EPS tahun ke tahun bertingkat (≥15% / ≥30%); bebas daripada pendapatan bersih kerana pembelian balik saham boleh memperbesarkan pergerakan EPS. CAPEX_INCREASE/STRONG_CAPEX_INCREASE dan varian DECLINE: perubahan perbelanjaan modal tahun ke tahun bertingkat dalam magnitud perbelanjaan (≥15% / ≥30%).

          nilai
          • MARGIN_EXPANSION
          • MARGIN_CONTRACTION
          • GUIDANCE_RAISED
          • GUIDANCE_LOWERED
          • GUIDANCE_REAFFIRMED
        • details
          Jenis: object

          Medan berstruktur khusus kepada jenis isyarat. Kandungannya berbeza: isyarat panduan membawa low, high, point_estimate, prior_value, revision_pct; isyarat segmen membawa best, worst, spread_pp; isyarat bukan GAAP membawa gaap_field, non_gaap_value, gaap_value, divergence_pct; isyarat pertumbuhan membawa current, yoy_chg. Nilai null ditiadakan. Rujuk contoh khusus jenis.

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

          Metrik yang dirujuk isyarat ini, apabila berkenaan (contohnya revenue, earnings_per_share, operating_margin, atau nama metrik panduan/KPI).

        • period
          Jenis: string | null

          Tempoh fiskal yang dirujuk isyarat (contohnya 2026-Q1, FY 2026). Isyarat panduan ke hadapan merujuk tempoh yang dipandu; isyarat kewangan merujuk tempoh laporan pemfailan ini.

    • next_page_url
      Jenis: string

      URL mutlak halaman hasil seterusnya. Hadir hanya apabila masih ada hasil; minta sebagaimana adanya untuk meneruskan. Setiap halaman memuatkan sehingga 10 rekod.

    application/json
  • 400

    Permintaan tidak dapat diproses. Semak parameter permintaan.

  • 401

    Kunci API Felo yang sah diperlukan.

  • 402

    Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.

  • 403

    Akaun tidak dibenarkan melakukan operasi ini.

  • 429

    Had permintaan atau had perbelanjaan telah dicapai.

  • 502

    Perkhidmatan tidak dapat menyelesaikan permintaan.

  • 503

    API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.

  • 504

    Perkhidmatan tamat masa semasa memproses permintaan.

  • default

    Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

    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