Những API có thể dùng để lấy lịch earnings và kiểm tra beat/miss của cổ phiếu Mỹ

2. AInvest – dữ liệu surprise khá trực tiếp

API earnings calendar của AInvest trả về các trường rất hữu ích cho phân tích kết quả earnings như:

• eps_actual
• eps_forecast
• eps_surprise
• revenue_actual
• revenue_forecast

Vì vậy việc xác định kết quả khá đơn giản:

• eps_actual > eps_forecast → Beat (cao hơn kỳ vọng)
• eps_actual < eps_forecast → Miss (thấp hơn kỳ vọng)
• eps_actual == eps_forecast → Inline

Dạng API call:

GET https://openapi.ainvest.com/open/calendar/earnings
Authorization: Bearer <token>

3. Bigdata – phù hợp truy vấn earnings surprise

Bigdata cung cấp endpoint Earnings Surprises với các trường dữ liệu như:

• reporting_date
• eps_actual
• eps_estimated
• revenue_actual
• revenue_estimated
• eps_surprise_pct

Ví dụ dữ liệu:

eps_actual: 2.31
eps_estimated: 2.15

Từ đó hệ thống có thể tự tính phần trăm vượt kỳ vọng.

API này phù hợp cho:

• kiểm tra kết quả sau khi earnings đã phát hành
• đánh dấu beat/miss trong bảng tín hiệu giao dịch

4. Các API thay thế khác

Ngoài các lựa chọn trên, còn nhiều dịch vụ cung cấp dữ liệu earnings calendar:

API Ninjas
Cung cấp lịch earnings trong quá khứ và tương lai cho các công ty lớn.

Finnhub
Có endpoint earnings calendar và earnings surprises, bao gồm EPS estimate, EPS actual và thời gian công bố.

EarningsAPI
Trả dữ liệu theo nhóm pre-market, after-hours, hoặc chưa xác định thời gian.

Những API này khá phổ biến trong các dashboard tài chính và công cụ trading automation.

Ví dụ cấu trúc dữ liệu cho hệ thống tín hiệu

Một bảng dữ liệu đơn giản có thể thiết kế như sau:

ticker
signal_time
earnings_date
earnings_session
eps_actual
eps_estimate
result

Logic xử lý:

if eps_actual is None:
    result = "pending"
elif eps_actual > eps_estimate:
    result = "beat"
elif eps_actual < eps_estimate:
    result = "miss"
else:
    result = "inline"

Sau đó hiển thị cho trader ví dụ:

NVDA | 2026‑05‑12 | after market | beat
AAPL | 2026‑05‑13 | before market | pending

Lưu ý quan trọng về thời điểm công bố

Không phải tất cả API đều chắc chắn trả về trường "before market open" hoặc "after market close". Tài liệu của nhiều dịch vụ chỉ xác nhận có ngày earnings và dữ liệu EPS, còn thời điểm chi tiết cần kiểm tra thực tế khi gọi API.

Vì vậy trước khi tích hợp vào production, nên:

• test 20–50 mã cổ phiếu
• kiểm tra các field như time, session, reportTime, hour
• xác nhận timezone (thường là Eastern Time – ET).

Kết luận

Nếu mục tiêu là tích hợp nhanh vào hệ thống giao dịch tự động:

• OpenBB: phù hợp làm nguồn dữ liệu earnings calendar chính, đặc biệt với Python.
• AInvest hoặc Bigdata: bổ sung dữ liệu EPS actual vs forecast để xác định beat/miss.
• Finnhub hoặc API Ninjas: lựa chọn thay thế để tăng độ ổn định nguồn dữ liệu.

Kết hợp 2–3 nguồn API thường là cách an toàn nhất khi xây hệ thống signal cho cổ phiếu Mỹ.