Financial Data
Company fundamentals, financial statements, market prices and economic data.
Lấy tất cả báo cáo tài chính
Tất cả ba báo cáo của một công ty trong một lần gọi. Trả về đối tượng financials chứa income_statements, balance_sheets và cash_flow_statements, mỗi báo cáo có cùng hình dạng như công cụ chuyên dụng trả về. period là bắt buộc (annual, quarterly hoặc ttm); xác định công ty bằng ticker hoặc cik và giới hạn bằng limit. Dùng khi cần bức tranh đầy đủ và nếu không sẽ phải gọi ba lần. Khi chỉ cần một báo cáo, get_financial_financials_income_statements, get_financial_financials_balance_sheets hoặc get_financial_financials_cash_flow_statements trả về ít dữ liệu hơn nhiều; khi cần một vài trường có tên cụ thể trên nhiều công ty, post_financial_financials_search_line_items còn hẹp hơn.
Tham chiếu giá
- Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.02.
- Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.
Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.
- Kiểu: stringcik
Central Index Key (CIK) của công ty.
- Kiểu: stringcursor
Con trỏ phân trang không trong suốt từ next_page_url của phản hồi trước. Khi được cung cấp, mọi tham số truy vấn khác đều bị bỏ qua: con trỏ mang theo các bộ lọc của yêu cầu gốc. Hãy đối xử với nó như một giá trị không trong suốt; không tự tạo hoặc sửa đổi.
- Kiểu: string Định dạng: datefiling
_date Lọc theo ngày nộp hồ sơ SEC chính xác ở định dạng YYYY-MM-DD. Các hàng không có ngày nộp hồ sơ đã biết sẽ bị loại trừ.
- Kiểu: string Định dạng: datefiling
_date _gt Lọc theo ngày nộp hồ sơ SEC muộn hơn ngày ở định dạng YYYY-MM-DD. Các hàng không có ngày nộp hồ sơ đã biết sẽ bị loại trừ.
- Kiểu: string Định dạng: datefiling
_date _gte Lọc theo ngày nộp hồ sơ SEC muộn hơn hoặc bằng ngày ở định dạng YYYY-MM-DD. Các hàng không có ngày nộp hồ sơ đã biết sẽ bị loại trừ.
- Kiểu: string Định dạng: datefiling
_date _lt Lọc theo ngày nộp hồ sơ SEC sớm hơn ngày ở định dạng YYYY-MM-DD. Các hàng không có ngày nộp hồ sơ đã biết sẽ bị loại trừ.
- Kiểu: string Định dạng: datefiling
_date _lte Lọc theo ngày nộp hồ sơ SEC sớm hơn hoặc bằng ngày ở định dạng YYYY-MM-DD. Hữu ích cho truy vấn theo thời điểm: chỉ trả về dữ liệu đã được nộp công khai trước ngày đã cho. Các hàng không có ngày nộp hồ sơ đã biết sẽ bị loại trừ.
- Kiểu: integer Định dạng: int32limit
Số báo cáo tài chính tối đa cần trả về. Đây là tổng trên tất cả các trang, không phải kích thước trang: mỗi trang chứa tối đa 10 bản ghi, liên kết qua
next_page_url. - Kiểu: string enumperiodbắt buộc
Khoảng thời gian của báo cáo tài chính.
giá trị- annual
- quarterly
- ttm
- Kiểu: string Định dạng: datereport
_period Lọc theo ngày kỳ báo cáo chính xác ở định dạng YYYY-MM-DD.
- Kiểu: string Định dạng: datereport
_period _gt Lọc theo kỳ báo cáo lớn hơn ngày ở định dạng YYYY-MM-DD.
- Kiểu: string Định dạng: datereport
_period _gte Lọc theo kỳ báo cáo lớn hơn hoặc bằng ngày ở định dạng YYYY-MM-DD.
- Kiểu: string Định dạng: datereport
_period _lt Lọc theo kỳ báo cáo nhỏ hơn ngày ở định dạng YYYY-MM-DD.
- Kiểu: string Định dạng: datereport
_period _lte Lọc theo kỳ báo cáo nhỏ hơn hoặc bằng ngày ở định dạng YYYY-MM-DD.
- Kiểu: stringticker
Mã ticker. Bắt buộc nếu không cung cấp cik.
- Kiểu: object · ResponseE40Feb4D3D6B_FinancialsResponse200
Phản hồi báo cáo tài chính
- Kiểu: objectfinancials
- balanceKiểu: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
_sheets - accessionKiểu: string | null
_number Số truy cập SEC của hồ sơ.
- accumulatedKiểu: number
_other _comprehensive _income Thu nhập toàn diện khác lũy kế của công ty.
- cashKiểu: number
_and _equivalents Tiền và các khoản tương đương tiền của công ty.
- currencyKiểu: string
Đơn vị tiền tệ mà dữ liệu tài chính được báo cáo.
- currentKiểu: number
_assets Tài sản ngắn hạn của công ty.
- currentKiểu: number
_debt Nợ ngắn hạn của công ty.
- currentKiểu: number
_investments Đầu tư ngắn hạn của công ty.
- currentKiểu: number
_liabilities Nợ phải trả ngắn hạn của công ty.
- deferredKiểu: number
_revenue Doanh thu chưa thực hiện của công ty.
- depositKiểu: number
_liabilities Nợ tiền gửi của công ty.
- filingKiểu: string | null Định dạng: date
_date Ngày lịch SEC chấp nhận hồ sơ, theo Giờ miền Đông (múi giờ hoạt động của SEC). Cặp ngày lịch với
filing_datetime. Null khi không có hồ sơ SEC có ngày được liên kết với hàng. - filingKiểu: string | null Định dạng: date-time
_datetime Dấu thời gian dưới ngày ghi lại thời điểm SEC chấp nhận hồ sơ, theo Giờ miền Đông. Lấy từ trường
acceptanceDateTimecủa SEC trên API submissions của EDGAR. Đi kèm vớifiling_date(độ chính xác ngày lịch của cùng sự kiện). - filingKiểu: string | null Định dạng: uri
_url URL tới hồ sơ SEC.
- fiscalKiểu: string
_period Kỳ tài chính của bảng cân đối kế toán.
- formKiểu: string | null
_type Biểu mẫu SEC mà hàng này được lấy từ (
10-K,10-Q/A,20-F,S-1, ...). Đúng biểu mẫu như khi nộp, nên các bản sửa đổi giữ hậu tố/A. Null khiperiodlàttm: cửa sổ mười hai tháng gần nhất có thể trải qua nhiều hồ sơ, nên chúng tôi không gán nó cho một hồ sơ. Một hàngquarterlycó thể mang10-Kkhi quý thứ tư được suy ra từ hồ sơ năm tài chính. - goodwillKiểu: number
_and _intangible _assets Lợi thế thương mại và tài sản vô hình của công ty.
- inventoryKiểu: number
Hàng tồn kho của công ty.
- investmentsKiểu: number
Các khoản đầu tư của công ty.
- nonKiểu: number
_current _assets Tài sản dài hạn của công ty.
- nonKiểu: number
_current _debt Nợ dài hạn của công ty.
- nonKiểu: number
_current _investments Đầu tư dài hạn của công ty.
- nonKiểu: number
_current _liabilities Nợ phải trả dài hạn của công ty.
- outstandingKiểu: number
_shares Số cổ phiếu đang lưu hành của công ty.
- periodKiểu: string enum
Khoảng thời gian của bảng cân đối kế toán.
giá trị- quarterly
- ttm
- annual
- propertyKiểu: number
_plant _and _equipment Bất động sản, nhà xưởng và thiết bị của công ty.
- reportKiểu: string Định dạng: date
_period Kỳ báo cáo của bảng cân đối kế toán.
- retainedKiểu: number
_earnings Lợi nhuận giữ lại của công ty.
- shareholdersKiểu: number
_equity Vốn chủ sở hữu của cổ đông công ty.
- taxKiểu: number
_assets Tài sản thuế của công ty.
- taxKiểu: number
_liabilities Nợ thuế của công ty.
- tickerKiểu: string
Mã ticker.
- totalKiểu: number
_assets Tổng tài sản của công ty.
- totalKiểu: number
_debt Tổng nợ của công ty.
- totalKiểu: number
_liabilities Tổng nợ phải trả của công ty.
- tradeKiểu: number
_and _non _trade _payables Các khoản phải trả thương mại và phi thương mại của công ty.
- tradeKiểu: number
_and _non _trade _receivables Các khoản phải thu thương mại và phi thương mại của công ty.
- cashKiểu: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
_flow _statements - accessionKiểu: string | null
_number Số truy cập SEC của hồ sơ.
- businessKiểu: number
_acquisitions _and _disposals Mua lại và thoái vốn doanh nghiệp của công ty.
- capitalKiểu: number
_expenditure Chi tiêu vốn của công ty.
- changeKiểu: number
_in _cash _and _equivalents Thay đổi tiền và các khoản tương đương tiền của công ty.
- currencyKiểu: string
Đơn vị tiền tệ mà dữ liệu tài chính được báo cáo.
- depreciationKiểu: number
_and _amortization Khấu hao của công ty.
- dividendsKiểu: number
_and _other _cash _distributions Cổ tức và các khoản phân phối tiền mặt khác của công ty.
- effectKiểu: number
_of _exchange _rate _changes Ảnh hưởng của thay đổi tỷ giá của công ty.
- endingKiểu: number
_cash _balance Số dư tiền mặt cuối kỳ của công ty.
- filingKiểu: string | null Định dạng: date
_date Ngày lịch SEC chấp nhận hồ sơ, theo Giờ miền Đông (múi giờ hoạt động của SEC). Cặp ngày lịch với
filing_datetime. Null khi không có hồ sơ SEC có ngày được liên kết với hàng. - filingKiểu: string | null Định dạng: date-time
_datetime Dấu thời gian dưới ngày ghi lại thời điểm SEC chấp nhận hồ sơ, theo Giờ miền Đông. Lấy từ trường
acceptanceDateTimecủa SEC trên API submissions của EDGAR. Đi kèm vớifiling_date(độ chính xác ngày lịch của cùng sự kiện). - filingKiểu: string | null Định dạng: uri
_url URL tới hồ sơ SEC.
- fiscalKiểu: string
_period Kỳ tài chính của báo cáo lưu chuyển tiền tệ.
- formKiểu: string | null
_type Biểu mẫu SEC mà hàng này được lấy từ (
10-K,10-Q/A,20-F,S-1, ...). Đúng biểu mẫu như khi nộp, nên các bản sửa đổi giữ hậu tố/A. Null khiperiodlàttm: cửa sổ mười hai tháng gần nhất có thể trải qua nhiều hồ sơ, nên chúng tôi không gán nó cho một hồ sơ. Một hàngquarterlycó thể mang10-Kkhi quý thứ tư được suy ra từ hồ sơ năm tài chính. - freeKiểu: number
_cash _flow Dòng tiền tự do của công ty.
- investmentKiểu: number
_acquisitions _and _disposals Mua và thanh lý các khoản đầu tư của công ty.
- issuanceKiểu: number
_or _purchase _of _equity _shares Phát hành hoặc mua lại cổ phiếu của công ty.
- issuanceKiểu: number
_or _repayment _of _debt _securities Phát hành hoặc hoàn trả chứng khoán nợ của công ty.
- netKiểu: number
_cash _flow _from _financing Dòng tiền thuần từ hoạt động tài chính của công ty.
- netKiểu: number
_cash _flow _from _investing Dòng tiền thuần từ hoạt động đầu tư của công ty.
- netKiểu: number
_cash _flow _from _operations Dòng tiền thuần từ hoạt động kinh doanh của công ty.
- netKiểu: number
_income Lợi nhuận ròng của công ty.
- periodKiểu: string enum
Khoảng thời gian của báo cáo lưu chuyển tiền tệ.
giá trị- quarterly
- ttm
- annual
- reportKiểu: string Định dạng: date
_period Kỳ báo cáo của báo cáo lưu chuyển tiền tệ.
- shareKiểu: number
_based _compensation Thù lao dựa trên cổ phiếu của công ty.
- tickerKiểu: string
Mã ticker.
- incomeKiểu: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
_statements - accessionKiểu: string | null
_number Số truy cập SEC của hồ sơ.
- consolidatedKiểu: number
_income Thu nhập hợp nhất của công ty.
- costKiểu: number
_of _revenue Giá vốn của công ty.
- currencyKiểu: string
Đơn vị tiền tệ mà dữ liệu tài chính được báo cáo.
- dividendsKiểu: number
_per _common _share Cổ tức trên mỗi cổ phiếu phổ thông của công ty.
- earningsKiểu: number
_per _share Thu nhập trên mỗi cổ phiếu của công ty.
- earningsKiểu: number
_per _share _diluted Thu nhập pha loãng trên mỗi cổ phiếu của công ty.
- ebitKiểu: number
Lợi nhuận trước lãi vay và thuế của công ty.
- filingKiểu: string | null Định dạng: date
_date Ngày lịch SEC chấp nhận hồ sơ, theo Giờ miền Đông (múi giờ hoạt động của SEC). Cặp ngày lịch với
filing_datetime. Null khi không có hồ sơ SEC có ngày được liên kết với hàng. - filingKiểu: string | null Định dạng: date-time
_datetime Dấu thời gian dưới ngày ghi lại thời điểm SEC chấp nhận hồ sơ, theo Giờ miền Đông. Lấy từ trường
acceptanceDateTimecủa SEC trên API submissions của EDGAR. Đi kèm vớifiling_date(độ chính xác ngày lịch của cùng sự kiện). - filingKiểu: string | null Định dạng: uri
_url URL tới hồ sơ SEC.
- fiscalKiểu: string
_period Kỳ tài chính của báo cáo kết quả hoạt động kinh doanh.
- formKiểu: string | null
_type Biểu mẫu SEC mà hàng này được lấy từ (
10-K,10-Q/A,20-F,S-1, ...). Đúng biểu mẫu như khi nộp, nên các bản sửa đổi giữ hậu tố/A. Null khiperiodlàttm: cửa sổ mười hai tháng gần nhất có thể trải qua nhiều hồ sơ, nên chúng tôi không gán nó cho một hồ sơ. Một hàngquarterlycó thể mang10-Kkhi quý thứ tư được suy ra từ hồ sơ năm tài chính. - grossKiểu: number
_profit Lợi nhuận gộp của công ty.
- incomeKiểu: number
_tax _expense Chi phí thuế thu nhập của công ty.
- interestKiểu: number
_expense Chi phí lãi vay của công ty.
- netKiểu: number
_income Lợi nhuận ròng của công ty.
- netKiểu: number
_income _common _stock Lợi nhuận ròng dành cho cổ đông phổ thông của công ty.
- netKiểu: number
_income _discontinued _operations Lợi nhuận ròng từ hoạt động đã chấm dứt của công ty.
- netKiểu: number
_income _non _controlling _interests Lợi nhuận ròng từ lợi ích không kiểm soát của công ty.
- operatingKiểu: number
_expense Chi phí hoạt động của công ty.
- operatingKiểu: number
_income Lợi nhuận hoạt động của công ty.
- periodKiểu: string enum
Khoảng thời gian của báo cáo kết quả hoạt động kinh doanh.
giá trị- quarterly
- ttm
- annual
- preferredKiểu: number
_dividends _impact Tác động của cổ tức ưu đãi lên lợi nhuận ròng của công ty.
- reportKiểu: string Định dạng: date
_period Kỳ báo cáo của báo cáo kết quả hoạt động kinh doanh.
- researchKiểu: number
_and _development Chi phí nghiên cứu và phát triển của công ty.
- revenueKiểu: number
Tổng doanh thu của công ty.
- sellingKiểu: number
_general _and _administrative _expenses Chi phí bán hàng, chi phí chung và chi phí quản lý của công ty.
- tickerKiểu: string
Mã ticker.
- weightedKiểu: number
_average _shares Số cổ phiếu bình quân gia quyền của công ty.
- weightedKiểu: number
_average _shares _diluted Số cổ phiếu bình quân gia quyền pha loãng của công ty.
- Kiểu: stringnext
_page _url URL tuyệt đối của trang kết quả tiếp theo. Chỉ xuất hiện khi còn kết quả; hãy yêu cầu nguyên văn để tiếp tục. Mỗi trang chứa tối đa 10 bản ghi.
application/json - 400
Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
- 401
Cần có khóa API Felo hợp lệ.
- 402
Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
- 403
Tài khoản không được phép thực hiện thao tác này.
- 429
Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
- 502
Dịch vụ không thể hoàn tất yêu cầu.
- 503
API hoặc dịch vụ thanh toán tạm thời không khả dụng.
- 504
Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
- default
Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/financials?period=annual' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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"
}