v0.2.0-beta

OpenAPI 3.1.0

Dapatkan semua penyata kewangan

Felo API Support

MIT

Pelayan

https://openapi.felo.ai

Pustaka Klien

Shell Curl

Financial Data

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

Financial Data Operasi

get/v1/beta/financial/financials

Dapatkan semua penyata kewangan

Ketiga-tiga penyata bagi satu syarikat dalam satu panggilan. Memulangkan objek financials yang memegang income_statements, balance_sheets dan cash_flow_statements, setiap satu dengan bentuk yang sama seperti yang dipulangkan alat khusus. period diperlukan (annual, quarterly atau ttm); kenal pasti syarikat dengan ticker atau cik dan hadkan dengan limit. Gunakan apabila anda memerlukan gambaran penuh dan jika tidak perlu membuat tiga panggilan. Apabila anda hanya memerlukan satu penyata, get_financial_financials_income_statements, get_financial_financials_balance_sheets atau get_financial_financials_cash_flow_statements memulangkan jauh lebih sedikit data; apabila anda memerlukan segelintir medan bernama merentas beberapa syarikat, post_financial_financials_search_line_items lebih sempit lagi.

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.
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 Format: int32

Bilangan maksimum penyata kewangan 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 penyata 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. Wajib jika cik tidak diberikan.

Respons

200
Jenis: object · ResponseE40Feb4D3D6B_FinancialsResponse

Respons penyata kewangan
financials
Jenis: object
balance_sheets
Jenis: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
accession_number
Jenis: string | null

Nombor aksesi SEC pemfailan.

accumulated_other_comprehensive_income
Jenis: number

Pendapatan komprehensif lain terkumpul syarikat.

cash_and_equivalents
Jenis: number

Tunai dan setara tunai syarikat.

currency
Jenis: string

Mata wang pelaporan data kewangan.

current_assets
Jenis: number

Aset semasa syarikat.

current_debt
Jenis: number

Hutang semasa syarikat.

current_investments
Jenis: number

Pelaburan semasa syarikat.

current_liabilities
Jenis: number

Liabiliti semasa syarikat.

deferred_revenue
Jenis: number

Hasil tertangguh syarikat.

deposit_liabilities
Jenis: number

Liabiliti deposit syarikat.

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 kunci kira-kira.

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.

goodwill_and_intangible_assets
Jenis: number

Muhibah dan aset tak ketara syarikat.

inventory
Jenis: number

Inventori syarikat.

investments
Jenis: number

Pelaburan syarikat.

non_current_assets
Jenis: number

Aset bukan semasa syarikat.

non_current_debt
Jenis: number

Hutang bukan semasa syarikat.

non_current_investments
Jenis: number

Pelaburan bukan semasa syarikat.

non_current_liabilities
Jenis: number

Liabiliti bukan semasa syarikat.

outstanding_shares
Jenis: number

Saham beredar syarikat.

period
Jenis: string enum

Tempoh masa kunci kira-kira.

nilai
quarterly
ttm
annual
property_plant_and_equipment
Jenis: number

Hartanah, loji dan peralatan syarikat.

report_period
Jenis: string Format: date

Tempoh laporan kunci kira-kira.

retained_earnings
Jenis: number

Perolehan tertahan syarikat.

shareholders_equity
Jenis: number

Ekuiti pemegang saham syarikat.

tax_assets
Jenis: number

Aset cukai syarikat.

tax_liabilities
Jenis: number

Liabiliti cukai syarikat.

ticker
Jenis: string

Simbol ticker.

total_assets
Jenis: number

Jumlah aset syarikat.

total_debt
Jenis: number

Jumlah hutang syarikat.

total_liabilities
Jenis: number

Jumlah liabiliti syarikat.

trade_and_non_trade_payables
Jenis: number

Akaun belum bayar perdagangan dan bukan perdagangan syarikat.

trade_and_non_trade_receivables
Jenis: number

Akaun belum terima perdagangan dan bukan perdagangan syarikat.

cash_flow_statements
Jenis: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
accession_number
Jenis: string | null

Nombor aksesi SEC pemfailan.

business_acquisitions_and_disposals
Jenis: number

Pengambilalihan dan pelupusan perniagaan syarikat.

capital_expenditure
Jenis: number

Perbelanjaan modal syarikat.

change_in_cash_and_equivalents
Jenis: number

Perubahan tunai dan setara tunai syarikat.

currency
Jenis: string

Mata wang pelaporan data kewangan.

depreciation_and_amortization
Jenis: number

Susut nilai dan pelunasan syarikat.

dividends_and_other_cash_distributions
Jenis: number

Dividen dan pengagihan tunai lain syarikat.

effect_of_exchange_rate_changes
Jenis: number

Kesan perubahan kadar tukaran syarikat.

ending_cash_balance
Jenis: number

Baki tunai akhir syarikat.

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 penyata aliran tunai.

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
Jenis: number

Aliran tunai bebas syarikat.

investment_acquisitions_and_disposals
Jenis: number

Pengambilalihan dan pelupusan pelaburan syarikat.

issuance_or_purchase_of_equity_shares
Jenis: number

Penerbitan atau pembelian saham ekuiti syarikat.

issuance_or_repayment_of_debt_securities
Jenis: number

Penerbitan atau pembayaran balik sekuriti hutang syarikat.

net_cash_flow_from_financing
Jenis: number

Aliran tunai bersih daripada pembiayaan syarikat.

net_cash_flow_from_investing
Jenis: number

Aliran tunai bersih daripada pelaburan syarikat.

net_cash_flow_from_operations
Jenis: number

Aliran tunai bersih daripada operasi syarikat.

net_income
Jenis: number

Pendapatan bersih syarikat.

period
Jenis: string enum

Tempoh masa penyata aliran tunai.

nilai
quarterly
ttm
annual
report_period
Jenis: string Format: date

Tempoh laporan penyata aliran tunai.

share_based_compensation
Jenis: number

Pampasan berasaskan saham syarikat.

ticker
Jenis: string

Simbol ticker.

income_statements
Jenis: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
accession_number
Jenis: string | null

Nombor aksesi SEC pemfailan.

consolidated_income
Jenis: number

Pendapatan disatukan syarikat.

cost_of_revenue
Jenis: number

Kos hasil syarikat.

currency
Jenis: string

Mata wang pelaporan data kewangan.

dividends_per_common_share
Jenis: number

Dividen sesaham biasa syarikat.

earnings_per_share
Jenis: number

Pendapatan sesaham syarikat.

earnings_per_share_diluted
Jenis: number

Pendapatan sesaham dicairkan syarikat.

ebit
Jenis: number

Pendapatan sebelum faedah dan cukai syarikat.

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 penyata pendapatan.

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.

gross_profit
Jenis: number

Untung kasar syarikat.

income_tax_expense
Jenis: number

Perbelanjaan cukai pendapatan syarikat.

interest_expense
Jenis: number

Perbelanjaan faedah syarikat.

net_income
Jenis: number

Pendapatan bersih syarikat.

net_income_common_stock
Jenis: number

Pendapatan bersih tersedia untuk pemegang saham biasa syarikat.

net_income_discontinued_operations
Jenis: number

Pendapatan bersih daripada operasi dihentikan syarikat.

net_income_non_controlling_interests
Jenis: number

Pendapatan bersih daripada kepentingan bukan pengawal syarikat.

operating_expense
Jenis: number

Perbelanjaan operasi syarikat.

operating_income
Jenis: number

Pendapatan operasi syarikat.

period
Jenis: string enum

Tempoh masa penyata pendapatan.

nilai
quarterly
ttm
annual
preferred_dividends_impact
Jenis: number

Kesan dividen keutamaan terhadap pendapatan bersih syarikat.

report_period
Jenis: string Format: date

Tempoh laporan penyata pendapatan.

research_and_development
Jenis: number

Perbelanjaan penyelidikan dan pembangunan syarikat.

revenue
Jenis: number

Jumlah hasil syarikat.

selling_general_and_administrative_expenses
Jenis: number

Perbelanjaan jualan, am dan pentadbiran syarikat.

ticker
Jenis: string

Simbol ticker.

weighted_average_shares
Jenis: number

Saham purata berwajaran syarikat.

weighted_average_shares_diluted
Jenis: number

Saham purata berwajaran dicairkan syarikat.

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

get/v1/beta/financial/financials

curl 'https://openapi.felo.ai/v1/beta/financial/financials?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Tunjukkan Skema

{
  "financials": {
    "income_statements": [
      {
        "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,
        "revenue": 1,
        "cost_of_revenue": 1,
        "gross_profit": 1,
        "operating_expense": 1,
        "selling_general_and_administrative_expenses": 1,
        "research_and_development": 1,
        "operating_income": 1,
        "interest_expense": 1,
        "ebit": 1,
        "income_tax_expense": 1,
        "net_income_discontinued_operations": 1,
        "net_income_non_controlling_interests": 1,
        "net_income": 1,
        "net_income_common_stock": 1,
        "preferred_dividends_impact": 1,
        "consolidated_income": 1,
        "earnings_per_share": 1,
        "earnings_per_share_diluted": 1,
        "dividends_per_common_share": 1,
        "weighted_average_shares": 1,
        "weighted_average_shares_diluted": 1
      }
    ],
    "balance_sheets": [
      {
        "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,
        "total_assets": 1,
        "current_assets": 1,
        "cash_and_equivalents": 1,
        "inventory": 1,
        "current_investments": 1,
        "trade_and_non_trade_receivables": 1,
        "non_current_assets": 1,
        "property_plant_and_equipment": 1,
        "goodwill_and_intangible_assets": 1,
        "investments": 1,
        "non_current_investments": 1,
        "outstanding_shares": 1,
        "tax_assets": 1,
        "total_liabilities": 1,
        "current_liabilities": 1,
        "current_debt": 1,
        "trade_and_non_trade_payables": 1,
        "deferred_revenue": 1,
        "deposit_liabilities": 1,
        "non_current_liabilities": 1,
        "non_current_debt": 1,
        "tax_liabilities": 1,
        "shareholders_equity": 1,
        "retained_earnings": 1,
        "accumulated_other_comprehensive_income": 1,
        "total_debt": 1
      }
    ],
    "cash_flow_statements": [
      {
        "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,
        "net_income": 1,
        "depreciation_and_amortization": 1,
        "share_based_compensation": 1,
        "net_cash_flow_from_operations": 1,
        "capital_expenditure": 1,
        "business_acquisitions_and_disposals": 1,
        "investment_acquisitions_and_disposals": 1,
        "net_cash_flow_from_investing": 1,
        "issuance_or_repayment_of_debt_securities": 1,
        "issuance_or_purchase_of_equity_shares": 1,
        "dividends_and_other_cash_distributions": 1,
        "net_cash_flow_from_financing": 1,
        "change_in_cash_and_equivalents": 1,
        "effect_of_exchange_rate_changes": 1,
        "ending_cash_balance": 1,
        "free_cash_flow": 1
      }
    ]
  },
  "next_page_url": "string"
}

Respons penyata kewangan

Dapatkan semua penyata kewangan

PengesahanRequired

Financial Data

Dapatkan semua penyata kewangan

Rujukan harga