Financial Data
Company fundamentals, financial statements, market prices and economic data.
Lấy ảnh chụp thu nhập
Thu nhập được báo cáo cho một cổ phiếu, số thực tế so với ước tính. Mỗi mục gồm report_period, fiscal_period, filing_date, filing_url và accession_number, một khối quarterly với revenue, estimated_revenue, revenue_surprise và revenue_surprise_pct, bộ ba tương tự cho earnings_per_share, cùng các trường thay đổi so với cùng kỳ năm trước. Endpoint cũng trả về signals: các cờ do hệ thống thượng nguồn tính như EPS_BEAT với headline và actual / estimate / surprise_pct đằng sau. ticker là bắt buộc và là tham số duy nhất. Dùng cho những gì công ty thực sự báo cáo. Với đồng thuận dự báo chưa xảy ra, dùng get_financial_analyst_estimates.
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: 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: integerlimittối thiểu:1tối đa:40
Số kỳ báo cáo gần nhất cần trả về hồ sơ, sắp xếp theo
(report_period DESC, filing_date ASC). Số mục trả về có thể vượtlimitkhi một kỳ gần đây có cả 8-K và 10-Q / 10-K. Giá trị trên 40 sẽ bị giới hạn ở 40. Giá trị không dương hoặc không phải số nguyên trả về 400. Đâ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 quanext_page_url. - Kiểu: stringtickerbắt buộc
Mã ticker (ví dụ:
AAPL).
- Kiểu: object · ResponseE40Feb4D3D6B_EarningsResponse200
Phản hồi thu nhập
- Kiểu: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]earnings
Danh sách phẳng các hồ sơ SEC cho mã ticker, sắp xếp theo (report_period DESC, filing_date ASC). Khi
limit=N, trả về tối đa N kỳ báo cáo; số mục có thể vượt N khi một kỳ gần đây có cả 8-K và 10-Q/10-K.- accessionKiểu: string
_number bắt buộcSố truy cập SEC dùng để xác định hồ sơ nộp.
- filingKiểu: string Định dạng: date
_date bắt buộcNgà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. - filingKiểu: string Định dạng: uri
_url bắt buộcURL tới hồ sơ SEC.
- reportKiểu: string Định dạng: date
_period bắt buộcKỳ báo cáo mà hồ sơ này bao gồm.
- sourceKiểu: string enum
_type bắt buộcLoại biểu mẫu SEC đứng sau hồ sơ này.
giá trị- 8
- K - 10
- Q - 10
- K - 20
- F
- tickerKiểu: stringbắt buộc
Mã ticker được yêu cầu.
- annualKiểu: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
- capitalKiểu: number | null
_expenditure - capitalKiểu: number
_expenditure _chg Phần trăm thay đổi chi tiêu vốn so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- capitalKiểu: number
_expenditure _yoy _chg Thay đổi chi tiêu vốn so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- cashKiểu: number | null
_and _equivalents - changeKiểu: number | null
_in _cash _and _equivalents - earningsKiểu: number | null
_per _share - earningsKiểu: number
_per _share _chg Phần trăm thay đổi EPS so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- earningsKiểu: number
_per _share _yoy _chg Thay đổi EPS so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- freeKiểu: number | null
_cash _flow - freeKiểu: number
_cash _flow _chg Phần trăm thay đổi dòng tiền tự do so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- freeKiểu: number
_cash _flow _yoy _chg Thay đổi dòng tiền tự do so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- grossKiểu: number
_margin Biên lợi nhuận gộp dưới dạng số thập phân (gross_profit / revenue). Chỉ trả về khi tính được.
- grossKiểu: number
_margin _chg _bps Thay đổi tuyệt đối của biên lợi nhuận gộp so với kỳ trước, tính bằng điểm cơ bản (ví dụ 200.0 = biên tăng 200 bps). Chỉ trả về khi tính được.
- grossKiểu: number
_margin _chg _pct Phần trăm thay đổi biên lợi nhuận gộp so với kỳ trước, dưới dạng số thập phân. Chỉ trả về khi tính được.
- grossKiểu: number
_margin _yoy _chg _bps Thay đổi biên lợi nhuận gộp so với cùng quý tài chính một năm trước, tính bằng điểm cơ bản. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- grossKiểu: number
_margin _yoy _chg _pct Phần trăm thay đổi biên lợi nhuận gộp so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- grossKiểu: number | null
_profit - grossKiểu: number
_profit _chg Phần trăm thay đổi lợi nhuận gộp so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- grossKiểu: number
_profit _yoy _chg Thay đổi lợi nhuận gộp so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number | null
_cash _flow _from _financing - netKiểu: number
_cash _flow _from _financing _chg Phần trăm thay đổi dòng tiền thuần từ hoạt động tài chính so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- netKiểu: number
_cash _flow _from _financing _yoy _chg Thay đổi dòng tiền thuần từ hoạt động tài chính so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number | null
_cash _flow _from _investing - netKiểu: number
_cash _flow _from _investing _chg Phần trăm thay đổi dòng tiền thuần từ hoạt động đầu tư so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- netKiểu: number
_cash _flow _from _investing _yoy _chg Thay đổi dòng tiền thuần từ hoạt động đầu tư so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number | null
_cash _flow _from _operations - netKiểu: number
_cash _flow _from _operations _chg Phần trăm thay đổi dòng tiền thuần từ hoạt động kinh doanh so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- netKiểu: number
_cash _flow _from _operations _yoy _chg Thay đổi dòng tiền thuần từ hoạt động kinh doanh so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number | null
_income - netKiểu: number
_income _chg Phần trăm thay đổi lợi nhuận ròng so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- netKiểu: number
_income _yoy _chg Thay đổi lợi nhuận ròng so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number
_margin Biên lợi nhuận ròng dưới dạng số thập phân (net_income / revenue). Chỉ trả về khi tính được.
- netKiểu: number
_margin _chg _bps Thay đổi tuyệt đối của biên lợi nhuận ròng so với kỳ trước, tính bằng điểm cơ bản. Chỉ trả về khi tính được.
- netKiểu: number
_margin _chg _pct Phần trăm thay đổi biên lợi nhuận ròng so với kỳ trước, dưới dạng số thập phân. Chỉ trả về khi tính được.
- netKiểu: number
_margin _yoy _chg _bps Thay đổi biên lợi nhuận ròng so với cùng quý tài chính một năm trước, tính bằng điểm cơ bản. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number
_margin _yoy _chg _pct Phần trăm thay đổi biên lợi nhuận ròng so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- operatingKiểu: number | null
_income - operatingKiểu: number
_income _chg Phần trăm thay đổi lợi nhuận hoạt động so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- operatingKiểu: number
_income _yoy _chg Thay đổi lợi nhuận hoạt động so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- operatingKiểu: number
_margin Biên lợi nhuận hoạt động dưới dạng số thập phân (operating_income / revenue). Chỉ trả về khi tính được.
- operatingKiểu: number
_margin _chg _bps Thay đổi tuyệt đối của biên lợi nhuận hoạt động so với kỳ trước, tính bằng điểm cơ bản. Chỉ trả về khi tính được.
- operatingKiểu: number
_margin _chg _pct Phần trăm thay đổi biên lợi nhuận hoạt động so với kỳ trước, dưới dạng số thập phân. Chỉ trả về khi tính được.
- operatingKiểu: number
_margin _yoy _chg _bps Thay đổi biên lợi nhuận hoạt động so với cùng quý tài chính một năm trước, tính bằng điểm cơ bản. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- operatingKiểu: number
_margin _yoy _chg _pct Phần trăm thay đổi biên lợi nhuận hoạt động so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- revenueKiểu: number | null
- revenueKiểu: number
_chg Phần trăm thay đổi doanh thu so với kỳ trước, dưới dạng số thập phân (ví dụ 0.10 = +10%). Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- revenueKiểu: number
_yoy _chg Thay đổi doanh thu so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- shareholdersKiểu: number | null
_equity - totalKiểu: number | null
_assets - totalKiểu: number | null
_debt - totalKiểu: number | null
_liabilities - weightedKiểu: number | null
_average _shares - weightedKiểu: number | null
_average _shares _diluted
- currencyKiểu: string
Mã tiền tệ ISO (ví dụ USD).
- 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 enum
_window Phiên thị trường tại thời điểm SEC chấp nhận hồ sơ, được đánh giá theo Giờ miền Đông. PRE_MARKET = ngày thường 04:00–09:30 ET. DURING_MARKET = ngày thường 09:30–16:00 ET. AFTER_HOURS = ngày thường ngoài giờ giao dịch thông thường. WEEKEND = Thứ Bảy hoặc Chủ Nhật. Null khi filing_datetime không khả dụng.
giá trị- P
R E _ M A R K E T - D
U R I N G _ M A R K E T - A
F T E R _ H O U R S - W
E E K E N D
- fiscalKiểu: string
_period Nhãn kỳ tài chính (ví dụ 2026-Q1 hoặc 2025-FY).
- quarterlyKiểu: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
- capitalKiểu: number | null
_expenditure - capitalKiểu: number
_expenditure _chg Phần trăm thay đổi chi tiêu vốn so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- capitalKiểu: number
_expenditure _yoy _chg Thay đổi chi tiêu vốn so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- cashKiểu: number | null
_and _equivalents - changeKiểu: number | null
_in _cash _and _equivalents - earningsKiểu: number | null
_per _share - earningsKiểu: number
_per _share _chg Phần trăm thay đổi EPS so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- earningsKiểu: number
_per _share _yoy _chg Thay đổi EPS so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- freeKiểu: number | null
_cash _flow - freeKiểu: number
_cash _flow _chg Phần trăm thay đổi dòng tiền tự do so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- freeKiểu: number
_cash _flow _yoy _chg Thay đổi dòng tiền tự do so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- grossKiểu: number
_margin Biên lợi nhuận gộp dưới dạng số thập phân (gross_profit / revenue). Chỉ trả về khi tính được.
- grossKiểu: number
_margin _chg _bps Thay đổi tuyệt đối của biên lợi nhuận gộp so với kỳ trước, tính bằng điểm cơ bản (ví dụ 200.0 = biên tăng 200 bps). Chỉ trả về khi tính được.
- grossKiểu: number
_margin _chg _pct Phần trăm thay đổi biên lợi nhuận gộp so với kỳ trước, dưới dạng số thập phân. Chỉ trả về khi tính được.
- grossKiểu: number
_margin _yoy _chg _bps Thay đổi biên lợi nhuận gộp so với cùng quý tài chính một năm trước, tính bằng điểm cơ bản. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- grossKiểu: number
_margin _yoy _chg _pct Phần trăm thay đổi biên lợi nhuận gộp so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- grossKiểu: number | null
_profit - grossKiểu: number
_profit _chg Phần trăm thay đổi lợi nhuận gộp so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- grossKiểu: number
_profit _yoy _chg Thay đổi lợi nhuận gộp so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number | null
_cash _flow _from _financing - netKiểu: number
_cash _flow _from _financing _chg Phần trăm thay đổi dòng tiền thuần từ hoạt động tài chính so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- netKiểu: number
_cash _flow _from _financing _yoy _chg Thay đổi dòng tiền thuần từ hoạt động tài chính so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number | null
_cash _flow _from _investing - netKiểu: number
_cash _flow _from _investing _chg Phần trăm thay đổi dòng tiền thuần từ hoạt động đầu tư so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- netKiểu: number
_cash _flow _from _investing _yoy _chg Thay đổi dòng tiền thuần từ hoạt động đầu tư so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number | null
_cash _flow _from _operations - netKiểu: number
_cash _flow _from _operations _chg Phần trăm thay đổi dòng tiền thuần từ hoạt động kinh doanh so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- netKiểu: number
_cash _flow _from _operations _yoy _chg Thay đổi dòng tiền thuần từ hoạt động kinh doanh so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number | null
_income - netKiểu: number
_income _chg Phần trăm thay đổi lợi nhuận ròng so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- netKiểu: number
_income _yoy _chg Thay đổi lợi nhuận ròng so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number
_margin Biên lợi nhuận ròng dưới dạng số thập phân (net_income / revenue). Chỉ trả về khi tính được.
- netKiểu: number
_margin _chg _bps Thay đổi tuyệt đối của biên lợi nhuận ròng so với kỳ trước, tính bằng điểm cơ bản. Chỉ trả về khi tính được.
- netKiểu: number
_margin _chg _pct Phần trăm thay đổi biên lợi nhuận ròng so với kỳ trước, dưới dạng số thập phân. Chỉ trả về khi tính được.
- netKiểu: number
_margin _yoy _chg _bps Thay đổi biên lợi nhuận ròng so với cùng quý tài chính một năm trước, tính bằng điểm cơ bản. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- netKiểu: number
_margin _yoy _chg _pct Phần trăm thay đổi biên lợi nhuận ròng so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- operatingKiểu: number | null
_income - operatingKiểu: number
_income _chg Phần trăm thay đổi lợi nhuận hoạt động so với kỳ trước, dưới dạng số thập phân. Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- operatingKiểu: number
_income _yoy _chg Thay đổi lợi nhuận hoạt động so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- operatingKiểu: number
_margin Biên lợi nhuận hoạt động dưới dạng số thập phân (operating_income / revenue). Chỉ trả về khi tính được.
- operatingKiểu: number
_margin _chg _bps Thay đổi tuyệt đối của biên lợi nhuận hoạt động so với kỳ trước, tính bằng điểm cơ bản. Chỉ trả về khi tính được.
- operatingKiểu: number
_margin _chg _pct Phần trăm thay đổi biên lợi nhuận hoạt động so với kỳ trước, dưới dạng số thập phân. Chỉ trả về khi tính được.
- operatingKiểu: number
_margin _yoy _chg _bps Thay đổi biên lợi nhuận hoạt động so với cùng quý tài chính một năm trước, tính bằng điểm cơ bản. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- operatingKiểu: number
_margin _yoy _chg _pct Phần trăm thay đổi biên lợi nhuận hoạt động so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- revenueKiểu: number | null
- revenueKiểu: number
_chg Phần trăm thay đổi doanh thu so với kỳ trước, dưới dạng số thập phân (ví dụ 0.10 = +10%). Tuần tự trong payload hàng quý, so với cùng kỳ năm trước trong payload hàng năm. Chỉ trả về khi tính được.
- revenueKiểu: number
_yoy _chg Thay đổi doanh thu so với cùng quý tài chính một năm trước, dưới dạng số thập phân. Chỉ có trong payload hàng quý. Chỉ trả về khi tính được.
- shareholdersKiểu: number | null
_equity - totalKiểu: number | null
_assets - totalKiểu: number | null
_debt - totalKiểu: number | null
_liabilities - weightedKiểu: number | null
_average _shares - weightedKiểu: number | null
_average _shares _diluted
- signalsKiểu: array object[] · ResponseE40Feb4D3D6B_Signal[]
Thông tin chi tiết chọn lọc, có khả năng tác động thị trường, được chắt lọc từ hồ sơ này. Mỗi mục có
headlineđược kết xuất sẵn,detailscó cấu trúc và xếp hạngimportance. Chỉ trả về khi có ít nhất một tín hiệu kích hoạt cho mục này; nếu không, trường bị bỏ qua. Tối đa 8 mỗi mục, sắp xếp HIGH → MEDIUM → LOW.Thông tin chọn lọc có khả năng tác động thị trường, được suy ra từ hồ sơ này.
headlineđược kết xuất sẵn để hiển thị trực tiếp;detailschứa các trường có cấu trúc để lọc và dùng theo chương trình. Các tín hiệu được trả về theo thứ tự ưu tiên (quan trọng nhất trước); bản thântypemã hóa độ lớn (ví dụSTRONG_REVENUE_INCREASEso vớiREVENUE_INCREASE).- headlineKiểu: stringbắt buộc
Tóm tắt dễ đọc được kết xuất sẵn, phù hợp để hiển thị trực tiếp.
- typeKiểu: string enumbắt buộc
Danh mục tín hiệu. MARGIN_EXPANSION/MARGIN_CONTRACTION: bất kỳ biên gộp/hoạt động/ròng nào thay đổi so với cùng kỳ năm trước từ ≥100bps. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: thay đổi hướng dẫn hướng tới tương lai được báo cáo trong hồ sơ. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: phân khúc báo cáo có hiệu suất tốt nhất hoặc kém nhất theo tăng trưởng doanh thu hữu cơ. NON_GAAP_DIVERGENCE: số liệu điều chỉnh/phi GAAP khác biệt đáng kể so với số liệu GAAP tương ứng trong cùng kỳ. BACKLOG_SURGE/BACKLOG_DECLINE: backlog hoặc nghĩa vụ thực hiện còn lại thay đổi so với cùng kỳ năm trước từ ≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE và các biến thể DECLINE: thay đổi doanh thu so với cùng kỳ năm trước theo bậc (độ lớn ≥10% / ≥20%). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE và các biến thể DECLINE: thay đổi lợi nhuận ròng so với cùng kỳ năm trước theo bậc (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE và các biến thể DECLINE: thay đổi EPS so với cùng kỳ năm trước theo bậc (≥15% / ≥30%); độc lập với lợi nhuận ròng vì việc mua lại cổ phiếu có thể khuếch đại biến động EPS. CAPEX_INCREASE/STRONG_CAPEX_INCREASE và các biến thể DECLINE: thay đổi chi tiêu vốn so với cùng kỳ năm trước theo bậc về quy mô chi tiêu (≥15% / ≥30%).
giá trị- M
A R G I N _ E X P A N S I O N - M
A R G I N _ C O N T R A C T I O N - G
U I D A N C E _ R A I S E D - G
U I D A N C E _ L O W E R E D - G
U I D A N C E _ R E A F F I R M E D
- detailsKiểu: object
Các trường có cấu trúc dành riêng cho loại tín hiệu. Nội dung thay đổi: tín hiệu hướng dẫn mang
low,high,point_estimate,prior_value,revision_pct; tín hiệu phân khúc mangbest,worst,spread_pp; tín hiệu phi GAAP manggaap_field,non_gaap_value,gaap_value,divergence_pct; tín hiệu tăng trưởng mangcurrent,yoy_chg. Giá trị null bị bỏ qua. Tham khảo các ví dụ theo từng loại.- propertyKiểu: anything
Name
- metricKiểu: string | null
Chỉ số mà tín hiệu này tham chiếu, khi có (ví dụ
revenue,earnings_per_share,operating_margin, hoặc tên chỉ số hướng dẫn/KPI). - periodKiểu: string | null
Kỳ tài chính mà tín hiệu tham chiếu (ví dụ
2026-Q1,FY 2026). Tín hiệu hướng dẫn tương lai tham chiếu kỳ được dự báo; tín hiệu tài chính tham chiếu kỳ báo cáo của hồ sơ này.
- 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/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"
}