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

Dapatkan cuplikan laba

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

Financial Data

​

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

Financial Data Operasi

Dapatkan cuplikan laba

​

Laba yang dilaporkan untuk satu saham, aktual dibandingkan estimasi. 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, plus field perubahan tahun ke tahun. Endpoint juga mengembalikan signals: flag yang dihitung upstream seperti EPS_BEAT dengan headline serta actual / estimate / surprise_pct di baliknya. ticker wajib dan merupakan satu-satunya parameter. Gunakan untuk apa yang benar-benar dilaporkan perusahaan. Untuk konsensus prospektif yang belum terjadi, gunakan get_financial_analyst_estimates.

Referensi harga

  • Metering: Dasar biaya tetap per permintaan berhasil.
  • Estimasi referensi per permintaan: USD 0.02.
  • Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Parameter Kueri
  • cursor
    Tipe: string

    Kursor paginasi buram dari next_page_url respons sebelumnya. Jika diberikan, semua parameter kueri lain diabaikan: kursor membawa filter dari permintaan asli. Perlakukan sebagai nilai buram; jangan membuat atau mengubahnya.

  • limit
    Tipe: integer
    min:  
    1
    maks:  
    40

    Jumlah periode laporan terbaru yang pengajuannya akan dikembalikan, diurutkan berdasarkan (report_period DESC, filing_date ASC). Jumlah entri yang dikembalikan dapat melebihi limit ketika periode terbaru memiliki 8-K sekaligus 10-Q / 10-K. Nilai di atas 40 dibatasi menjadi 40. Nilai non-positif atau bukan bilangan bulat mengembalikan 400. Ini adalah total di semua halaman, bukan ukuran halaman: setiap halaman menampung hingga 10 catatan, ditautkan oleh next_page_url.

  • ticker
    Tipe: string
    wajib

    Simbol ticker (misalnya AAPL).

Respons
  • 200
    Tipe: object · ResponseE40Feb4D3D6B_EarningsResponse

    Respons laba

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

      Daftar datar pengajuan SEC untuk ticker, diurutkan berdasarkan (report_period DESC, filing_date ASC). Saat limit=N, hingga N report_period pengajuan dikembalikan; jumlah entri dapat melebihi N jika periode terbaru memiliki 8-K dan 10-Q/10-K sekaligus.

      • accession_number
        Tipe: string
        wajib

        Nomor aksesi SEC yang mengidentifikasi pengajuan.

      • filing_date
        Tipe: string Format: date
        wajib

        Hari kalender saat SEC menerima pengajuan, dalam Waktu Timur (zona waktu operasional SEC). Pasangan hari kalender untuk filing_datetime.

      • filing_url
        Tipe: string Format: uri
        wajib

        URL ke pengajuan SEC.

      • report_period
        Tipe: string Format: date
        wajib

        Periode laporan yang dicakup pengajuan ini.

      • source_type
        Tipe: string enum
        wajib

        Jenis formulir SEC yang mendasari pengajuan ini.

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

        Simbol ticker yang diminta.

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

          Persentase perubahan belanja modal dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • capital_expenditure_yoy_chg
          Tipe: number

          Perubahan belanja modal dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

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

          Persentase perubahan EPS dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • earnings_per_share_yoy_chg
          Tipe: number

          Perubahan EPS dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • free_cash_flow
          Tipe: number | null
        • free_cash_flow_chg
          Tipe: number

          Persentase perubahan arus kas bebas dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • free_cash_flow_yoy_chg
          Tipe: number

          Perubahan arus kas bebas dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • gross_margin
          Tipe: number

          Margin laba kotor sebagai desimal (gross_profit / revenue). Hanya dikembalikan jika dapat dihitung.

        • gross_margin_chg_bps
          Tipe: number

          Perubahan absolut margin laba kotor dibandingkan periode sebelumnya dalam basis poin (misalnya 200.0 = margin melebar 200 bps). Hanya dikembalikan jika dapat dihitung.

        • gross_margin_chg_pct
          Tipe: number

          Persentase perubahan margin laba kotor dibandingkan periode sebelumnya sebagai desimal. Hanya dikembalikan jika dapat dihitung.

        • gross_margin_yoy_chg_bps
          Tipe: number

          Perubahan margin laba kotor dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, dalam basis poin. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • gross_margin_yoy_chg_pct
          Tipe: number

          Persentase perubahan margin laba kotor dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • gross_profit
          Tipe: number | null
        • gross_profit_chg
          Tipe: number

          Persentase perubahan laba kotor dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • gross_profit_yoy_chg
          Tipe: number

          Perubahan laba kotor dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_financing
          Tipe: number | null
        • net_cash_flow_from_financing_chg
          Tipe: number

          Persentase perubahan arus kas bersih dari pendanaan dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_financing_yoy_chg
          Tipe: number

          Perubahan arus kas bersih dari pendanaan dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_investing
          Tipe: number | null
        • net_cash_flow_from_investing_chg
          Tipe: number

          Persentase perubahan arus kas bersih dari investasi dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_investing_yoy_chg
          Tipe: number

          Perubahan arus kas bersih dari investasi dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_operations
          Tipe: number | null
        • net_cash_flow_from_operations_chg
          Tipe: number

          Persentase perubahan arus kas bersih dari operasi dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_operations_yoy_chg
          Tipe: number

          Perubahan arus kas bersih dari operasi dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_income
          Tipe: number | null
        • net_income_chg
          Tipe: number

          Persentase perubahan laba bersih dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • net_income_yoy_chg
          Tipe: number

          Perubahan laba bersih dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_margin
          Tipe: number

          Margin bersih sebagai desimal (net_income / revenue). Hanya dikembalikan jika dapat dihitung.

        • net_margin_chg_bps
          Tipe: number

          Perubahan absolut margin bersih dibandingkan periode sebelumnya dalam basis poin. Hanya dikembalikan jika dapat dihitung.

        • net_margin_chg_pct
          Tipe: number

          Persentase perubahan margin bersih dibandingkan periode sebelumnya sebagai desimal. Hanya dikembalikan jika dapat dihitung.

        • net_margin_yoy_chg_bps
          Tipe: number

          Perubahan margin bersih dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, dalam basis poin. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_margin_yoy_chg_pct
          Tipe: number

          Persentase perubahan margin bersih dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • operating_income
          Tipe: number | null
        • operating_income_chg
          Tipe: number

          Persentase perubahan laba operasi dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • operating_income_yoy_chg
          Tipe: number

          Perubahan laba operasi dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • operating_margin
          Tipe: number

          Margin operasi sebagai desimal (operating_income / revenue). Hanya dikembalikan jika dapat dihitung.

        • operating_margin_chg_bps
          Tipe: number

          Perubahan absolut margin operasi dibandingkan periode sebelumnya dalam basis poin. Hanya dikembalikan jika dapat dihitung.

        • operating_margin_chg_pct
          Tipe: number

          Persentase perubahan margin operasi dibandingkan periode sebelumnya sebagai desimal. Hanya dikembalikan jika dapat dihitung.

        • operating_margin_yoy_chg_bps
          Tipe: number

          Perubahan margin operasi dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, dalam basis poin. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • operating_margin_yoy_chg_pct
          Tipe: number

          Persentase perubahan margin operasi dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • revenue
          Tipe: number | null
        • revenue_chg
          Tipe: number

          Persentase perubahan pendapatan dibandingkan periode sebelumnya sebagai desimal (misalnya 0.10 = +10%). Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • revenue_yoy_chg
          Tipe: number

          Perubahan pendapatan dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

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

        Kode mata uang ISO (misalnya USD).

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

        Stempel waktu sub-hari yang mencatat kapan SEC menerima pengajuan, dalam Waktu Timur. Bersumber dari field acceptanceDateTime SEC pada API submissions EDGAR. Berpasangan dengan filing_date (presisi hari kalender dari peristiwa yang sama).

      • filing_window
        Tipe: string | null enum

        Sesi pasar saat SEC menerima pengajuan, dievaluasi dalam Waktu Timur. PRE_MARKET = hari kerja 04:00–09:30 ET. DURING_MARKET = hari kerja 09:30–16:00 ET. AFTER_HOURS = hari kerja di luar jam perdagangan reguler. WEEKEND = Sabtu atau Minggu. Null jika filing_datetime tidak tersedia.

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

        Label periode fiskal (misalnya 2026-Q1 atau 2025-FY).

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

          Persentase perubahan belanja modal dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • capital_expenditure_yoy_chg
          Tipe: number

          Perubahan belanja modal dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

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

          Persentase perubahan EPS dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • earnings_per_share_yoy_chg
          Tipe: number

          Perubahan EPS dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • free_cash_flow
          Tipe: number | null
        • free_cash_flow_chg
          Tipe: number

          Persentase perubahan arus kas bebas dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • free_cash_flow_yoy_chg
          Tipe: number

          Perubahan arus kas bebas dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • gross_margin
          Tipe: number

          Margin laba kotor sebagai desimal (gross_profit / revenue). Hanya dikembalikan jika dapat dihitung.

        • gross_margin_chg_bps
          Tipe: number

          Perubahan absolut margin laba kotor dibandingkan periode sebelumnya dalam basis poin (misalnya 200.0 = margin melebar 200 bps). Hanya dikembalikan jika dapat dihitung.

        • gross_margin_chg_pct
          Tipe: number

          Persentase perubahan margin laba kotor dibandingkan periode sebelumnya sebagai desimal. Hanya dikembalikan jika dapat dihitung.

        • gross_margin_yoy_chg_bps
          Tipe: number

          Perubahan margin laba kotor dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, dalam basis poin. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • gross_margin_yoy_chg_pct
          Tipe: number

          Persentase perubahan margin laba kotor dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • gross_profit
          Tipe: number | null
        • gross_profit_chg
          Tipe: number

          Persentase perubahan laba kotor dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • gross_profit_yoy_chg
          Tipe: number

          Perubahan laba kotor dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_financing
          Tipe: number | null
        • net_cash_flow_from_financing_chg
          Tipe: number

          Persentase perubahan arus kas bersih dari pendanaan dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_financing_yoy_chg
          Tipe: number

          Perubahan arus kas bersih dari pendanaan dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_investing
          Tipe: number | null
        • net_cash_flow_from_investing_chg
          Tipe: number

          Persentase perubahan arus kas bersih dari investasi dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_investing_yoy_chg
          Tipe: number

          Perubahan arus kas bersih dari investasi dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_operations
          Tipe: number | null
        • net_cash_flow_from_operations_chg
          Tipe: number

          Persentase perubahan arus kas bersih dari operasi dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • net_cash_flow_from_operations_yoy_chg
          Tipe: number

          Perubahan arus kas bersih dari operasi dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_income
          Tipe: number | null
        • net_income_chg
          Tipe: number

          Persentase perubahan laba bersih dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • net_income_yoy_chg
          Tipe: number

          Perubahan laba bersih dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_margin
          Tipe: number

          Margin bersih sebagai desimal (net_income / revenue). Hanya dikembalikan jika dapat dihitung.

        • net_margin_chg_bps
          Tipe: number

          Perubahan absolut margin bersih dibandingkan periode sebelumnya dalam basis poin. Hanya dikembalikan jika dapat dihitung.

        • net_margin_chg_pct
          Tipe: number

          Persentase perubahan margin bersih dibandingkan periode sebelumnya sebagai desimal. Hanya dikembalikan jika dapat dihitung.

        • net_margin_yoy_chg_bps
          Tipe: number

          Perubahan margin bersih dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, dalam basis poin. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • net_margin_yoy_chg_pct
          Tipe: number

          Persentase perubahan margin bersih dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • operating_income
          Tipe: number | null
        • operating_income_chg
          Tipe: number

          Persentase perubahan laba operasi dibandingkan periode sebelumnya sebagai desimal. Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • operating_income_yoy_chg
          Tipe: number

          Perubahan laba operasi dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • operating_margin
          Tipe: number

          Margin operasi sebagai desimal (operating_income / revenue). Hanya dikembalikan jika dapat dihitung.

        • operating_margin_chg_bps
          Tipe: number

          Perubahan absolut margin operasi dibandingkan periode sebelumnya dalam basis poin. Hanya dikembalikan jika dapat dihitung.

        • operating_margin_chg_pct
          Tipe: number

          Persentase perubahan margin operasi dibandingkan periode sebelumnya sebagai desimal. Hanya dikembalikan jika dapat dihitung.

        • operating_margin_yoy_chg_bps
          Tipe: number

          Perubahan margin operasi dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, dalam basis poin. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • operating_margin_yoy_chg_pct
          Tipe: number

          Persentase perubahan margin operasi dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

        • revenue
          Tipe: number | null
        • revenue_chg
          Tipe: number

          Persentase perubahan pendapatan dibandingkan periode sebelumnya sebagai desimal (misalnya 0.10 = +10%). Berurutan dalam payload kuartalan, tahun ke tahun dalam payload tahunan. Hanya dikembalikan jika dapat dihitung.

        • revenue_yoy_chg
          Tipe: number

          Perubahan pendapatan dibandingkan kuartal fiskal yang sama satu tahun sebelumnya, sebagai desimal. Hanya payload kuartalan. Hanya dikembalikan jika dapat dihitung.

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

        Wawasan terkurasi yang berpotensi menggerakkan pasar, disaring dari pengajuan ini. Setiap item memiliki headline yang telah dirender, details terstruktur, dan peringkat importance. Hanya dikembalikan jika setidaknya satu sinyal aktif untuk entri ini; jika tidak, field dihilangkan. Maksimal 8 per entri, diurutkan HIGH → MEDIUM → LOW.

        Wawasan terkurasi yang berpotensi menggerakkan pasar yang diturunkan dari pengajuan ini. headline yang telah dirender cocok untuk ditampilkan langsung; details membawa field terstruktur untuk pemfilteran dan penggunaan programatik. Sinyal dikembalikan dalam urutan prioritas (paling material lebih dulu); type itu sendiri menyandikan besaran (misalnya STRONG_REVENUE_INCREASE vs REVENUE_INCREASE).

        • headline
          Tipe: string
          wajib

          Ringkasan yang telah dirender dan mudah dibaca, cocok untuk ditampilkan langsung.

        • type
          Tipe: string enum
          wajib

          Kategori sinyal. MARGIN_EXPANSION/MARGIN_CONTRACTION: salah satu margin kotor/operasi/bersih bergerak tahun ke tahun sebesar ≥100bps. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: perubahan panduan berwawasan ke depan yang dilaporkan dalam pengajuan. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: segmen yang dapat dilaporkan dengan kinerja terbaik atau terburuk berdasarkan pertumbuhan pendapatan organik. NON_GAAP_DIVERGENCE: angka yang disesuaikan/non-GAAP berbeda secara material dari padanan GAAP-nya pada periode yang sama. BACKLOG_SURGE/BACKLOG_DECLINE: backlog atau kewajiban kinerja tersisa bergerak tahun ke tahun sebesar ≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE dan varian DECLINE: perubahan pendapatan tahun ke tahun bertingkat (magnitudo ≥10% / ≥20%). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE dan varian DECLINE: perubahan laba bersih tahun ke tahun bertingkat (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE dan varian DECLINE: perubahan EPS tahun ke tahun bertingkat (≥15% / ≥30%); independen dari laba bersih karena pembelian kembali saham dapat memperbesar pergerakan EPS. CAPEX_INCREASE/STRONG_CAPEX_INCREASE dan varian DECLINE: perubahan belanja modal tahun ke tahun bertingkat dalam besaran pengeluaran (≥15% / ≥30%).

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

          Field terstruktur khusus untuk jenis sinyal. Isinya bervariasi: sinyal panduan membawa low, high, point_estimate, prior_value, revision_pct; sinyal segmen membawa best, worst, spread_pp; sinyal non-GAAP membawa gaap_field, non_gaap_value, gaap_value, divergence_pct; sinyal pertumbuhan membawa current, yoy_chg. Nilai null dihilangkan. Lihat contoh khusus per jenis.

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

          Metrik yang dirujuk sinyal ini, jika berlaku (misalnya revenue, earnings_per_share, operating_margin, atau nama metrik panduan/KPI).

        • period
          Tipe: string | null

          Periode fiskal yang dirujuk sinyal (misalnya 2026-Q1, FY 2026). Sinyal panduan ke depan merujuk periode yang dipandu; sinyal keuangan merujuk periode laporan pengajuan ini.

    • next_page_url
      Tipe: string

      URL absolut halaman hasil berikutnya. Hanya ada jika masih ada hasil; minta apa adanya untuk melanjutkan. Setiap halaman menampung hingga 10 catatan.

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat 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