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

Dapatkan metrik kewangan

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

Financial Data

​

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

Dapatkan metrik kewangan

​

Nisbah terkira bagi satu syarikat dari semasa ke semasa, kira-kira 49 setiap tempoh: market_cap, enterprise_value, price_to_earnings_ratio, price_to_book_ratio, price_to_sales_ratio, enterprise_value_to_ebitda_ratio, free_cash_flow_yield, peg_ratio, gross_margin, operating_margin, net_margin, return_on_equity, return_on_assets, return_on_invested_capital, nisbah pusing ganti dan kecairan, setiap satu dicap dengan report_period dan fiscal_period. period diperlukan; kenal pasti dengan ticker atau cik. Gunakan untuk melihat trend nisbah merentas tempoh. Untuk nilai semasa sahaja, get_financial_financial_metrics_snapshot ialah satu baris dan jauh lebih kecil.

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
  • cik
    Jenis: string

    Central Index Key (CIK) syarikat. Boleh digunakan sebagai ganti ticker.

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

  • filing_date
    Jenis: string Format: date

    Tapis mengikut tarikh pemfailan SEC yang tepat dalam format YYYY-MM-DD. Baris tanpa tarikh pemfailan yang diketahui dikecualikan.

  • filing_date_gt
    Jenis: string Format: date

    Tapis mengikut tarikh pemfailan SEC yang lebih baru daripada tarikh dalam format YYYY-MM-DD. Baris tanpa tarikh pemfailan yang diketahui dikecualikan.

  • filing_date_gte
    Jenis: string Format: date

    Tapis mengikut tarikh pemfailan SEC yang lebih baru daripada atau sama dengan tarikh dalam format YYYY-MM-DD. Baris tanpa tarikh pemfailan yang diketahui dikecualikan.

  • filing_date_lt
    Jenis: string Format: date

    Tapis mengikut tarikh pemfailan SEC yang lebih lama daripada tarikh dalam format YYYY-MM-DD. Baris tanpa tarikh pemfailan yang diketahui dikecualikan.

  • filing_date_lte
    Jenis: string Format: date

    Tapis mengikut tarikh pemfailan SEC yang lebih lama daripada atau sama dengan tarikh dalam format YYYY-MM-DD. Berguna untuk pertanyaan point-in-time: hanya memulangkan data yang telah difailkan secara awam pada tarikh tersebut. Baris tanpa tarikh pemfailan yang diketahui dikecualikan.

  • limit
    Jenis: integer

    Bilangan maksimum hasil untuk dipulangkan. Ini ialah jumlah merentas semua halaman, bukan saiz halaman: setiap halaman memuatkan sehingga 10 rekod, dipautkan oleh next_page_url.

  • period
    Jenis: string enum
    wajib

    Tempoh masa untuk data kewangan.

    nilai
    • annual
    • quarterly
    • ttm
  • report_period
    Jenis: string Format: date

    Tapis mengikut tarikh tempoh laporan yang tepat dalam format YYYY-MM-DD.

  • report_period_gt
    Jenis: string Format: date

    Tapis mengikut tempoh laporan lebih besar daripada tarikh dalam format YYYY-MM-DD.

  • report_period_gte
    Jenis: string Format: date

    Tapis mengikut tempoh laporan lebih besar daripada atau sama dengan tarikh dalam format YYYY-MM-DD.

  • report_period_lt
    Jenis: string Format: date

    Tapis mengikut tempoh laporan lebih kecil daripada tarikh dalam format YYYY-MM-DD.

  • report_period_lte
    Jenis: string Format: date

    Tapis mengikut tempoh laporan lebih kecil daripada atau sama dengan tarikh dalam format YYYY-MM-DD.

  • ticker
    Jenis: string

    Simbol ticker syarikat. Wajib jika cik tidak diberikan.

Respons
  • 200
    Jenis: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

    Metrik dan nisbah kewangan sejarah bagi sesuatu ticker

    • accession_number
      Jenis: string | null

      Nombor aksesi SEC pemfailan.

    • asset_turnover
      Jenis: number

      Hasil dibahagikan dengan purata jumlah aset.

    • book_value_growth
      Jenis: number

      Pertumbuhan nilai buku tahun ke tahun.

    • book_value_per_share
      Jenis: number

      Ekuiti pemegang saham dibahagikan dengan saham beredar.

    • cash_ratio
      Jenis: number

      Tunai dan setara tunai dibahagikan dengan liabiliti semasa.

    • currency
      Jenis: string

      Mata wang pelaporan data kewangan.

    • current_ratio
      Jenis: number

      Aset semasa dibahagikan dengan liabiliti semasa.

    • days_sales_outstanding
      Jenis: number

      Purata akaun belum terima dibahagikan dengan hasil sepanjang tempoh.

    • debt_to_assets
      Jenis: number

      Jumlah hutang dibahagikan dengan jumlah aset.

    • debt_to_equity
      Jenis: number

      Jumlah hutang dibahagikan dengan ekuiti pemegang saham.

    • earnings_growth
      Jenis: number

      Pertumbuhan pendapatan tahun ke tahun.

    • earnings_per_share
      Jenis: number

      Pendapatan bersih dibahagikan dengan purata berwajaran saham beredar.

    • earnings_per_share_growth
      Jenis: number

      Pertumbuhan pendapatan sesaham sepanjang tempoh.

    • ebitda_growth
      Jenis: number

      Pertumbuhan EBITDA sepanjang tempoh.

    • enterprise_value
      Jenis: number

      Jumlah nilai syarikat (permodalan pasaran + hutang - tunai).

    • enterprise_value_to_ebitda_ratio
      Jenis: number

      Nisbah nilai perusahaan kepada EBITDA.

    • enterprise_value_to_revenue_ratio
      Jenis: number

      Nisbah nilai perusahaan kepada hasil.

    • filing_date
      Jenis: string | null Format: date

      Hari kalendar SEC menerima pemfailan, dalam Waktu Timur (zon waktu operasi SEC). Pasangan hari kalendar untuk filing_datetime. Null apabila tiada pemfailan SEC bertarikh dipautkan pada baris.

    • 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_url
      Jenis: string | null Format: uri

      URL ke pemfailan SEC.

    • fiscal_period
      Jenis: string

      Tempoh fiskal metrik kewangan.

    • form_type
      Jenis: string | null

      Borang SEC asal baris ini (10-K, 10-Q/A, 20-F, S-1, ...). Borang tepat seperti yang difailkan, jadi pindaan mengekalkan akhiran /A. Null apabila period ialah ttm: tetingkap dua belas bulan bergolek boleh merangkumi berbilang pemfailan, jadi kami tidak mengaitkannya dengan satu pemfailan. Baris quarterly boleh membawa 10-K apabila suku keempat diperoleh daripada pemfailan tahun fiskal.

    • free_cash_flow_growth
      Jenis: number

      Pertumbuhan aliran tunai bebas sepanjang tempoh.

    • free_cash_flow_per_share
      Jenis: number

      Aliran tunai bebas dibahagikan dengan saham beredar.

    • free_cash_flow_yield
      Jenis: number

      Hasil aliran tunai bebas.

    • gross_margin
      Jenis: number

      Untung kasar sebagai peratusan hasil.

    • interest_coverage
      Jenis: number

      EBIT dibahagikan dengan perbelanjaan faedah.

    • inventory_turnover
      Jenis: number

      Kos barangan dijual dibahagikan dengan purata inventori.

    • net_margin
      Jenis: number

      Pendapatan bersih sebagai peratusan hasil.

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

    • operating_cash_flow_ratio
      Jenis: number

      Aliran tunai operasi dibahagikan dengan liabiliti semasa.

    • operating_cycle
      Jenis: number

      Pusing ganti inventori + pusing ganti belum terima.

    • operating_income_growth
      Jenis: number

      Pertumbuhan pendapatan operasi sepanjang tempoh.

    • operating_margin
      Jenis: number

      Pendapatan operasi sebagai peratusan hasil.

    • payout_ratio
      Jenis: number

      Dividen yang dibayar sebagai peratusan pendapatan bersih.

    • peg_ratio
      Jenis: number

      Nisbah harga kepada pertumbuhan pendapatan.

    • period
      Jenis: string enum

      Tempoh masa metrik kewangan.

      nilai
      • quarterly
      • ttm
      • annual
    • price_to_book_ratio
      Jenis: number

      Nisbah harga kepada nilai buku.

    • price_to_earnings_ratio
      Jenis: number

      Nisbah harga kepada pendapatan.

    • price_to_sales_ratio
      Jenis: number

      Nisbah harga kepada jualan.

    • quick_ratio
      Jenis: number

      Aset cair dibahagikan dengan liabiliti semasa.

    • receivables_turnover
      Jenis: number

      Hasil dibahagikan dengan purata akaun belum terima.

    • report_period
      Jenis: string Format: date

      Tempoh laporan metrik kewangan.

    • return_on_assets
      Jenis: number

      Pendapatan bersih sebagai peratusan jumlah aset.

    • return_on_equity
      Jenis: number

      Pendapatan bersih sebagai peratusan ekuiti pemegang saham.

    • return_on_invested_capital
      Jenis: number

      Untung operasi bersih selepas cukai sebagai peratusan modal dilaburkan.

    • revenue_growth
      Jenis: number

      Pertumbuhan hasil tahun ke tahun.

    • ticker
      Jenis: string

      Simbol ticker syarikat.

    • working_capital_turnover
      Jenis: number

      Hasil dibahagikan dengan purata modal kerja.

    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/financial-metrics
curl 'https://openapi.felo.ai/v1/beta/financial/financial-metrics?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "ticker": "string",
  "report_period": "2026-10-26",
  "fiscal_period": "string",
  "period": "quarterly",
  "currency": "string",
  "accession_number": null,
  "form_type": null,
  "filing_url": null,
  "filing_date": null,
  "filing_datetime": null,
  "enterprise_value": 1,
  "price_to_earnings_ratio": 1,
  "price_to_book_ratio": 1,
  "price_to_sales_ratio": 1,
  "enterprise_value_to_ebitda_ratio": 1,
  "enterprise_value_to_revenue_ratio": 1,
  "free_cash_flow_yield": 1,
  "peg_ratio": 1,
  "gross_margin": 1,
  "operating_margin": 1,
  "net_margin": 1,
  "return_on_equity": 1,
  "return_on_assets": 1,
  "return_on_invested_capital": 1,
  "asset_turnover": 1,
  "inventory_turnover": 1,
  "receivables_turnover": 1,
  "days_sales_outstanding": 1,
  "operating_cycle": 1,
  "working_capital_turnover": 1,
  "current_ratio": 1,
  "quick_ratio": 1,
  "cash_ratio": 1,
  "operating_cash_flow_ratio": 1,
  "debt_to_equity": 1,
  "debt_to_assets": 1,
  "interest_coverage": 1,
  "revenue_growth": 1,
  "earnings_growth": 1,
  "book_value_growth": 1,
  "earnings_per_share_growth": 1,
  "free_cash_flow_growth": 1,
  "operating_income_growth": 1,
  "ebitda_growth": 1,
  "payout_ratio": 1,
  "earnings_per_share": 1,
  "book_value_per_share": 1,
  "free_cash_flow_per_share": 1,
  "next_page_url": "string"
}
Get financial metrics