미국 주식 실적 발표 시간과 ‘예상 대비 서프라이즈’ 자동 판단을 위한 API

예시 구조:

이 데이터를 사용하면 프로그램에서 다음과 같이 자동 분류할 수 있습니다.

• actual > forecast → 예상 상회 (beat)
• actual < forecast → 예상 하회 (miss)
• actual = forecast → 예상 부합

즉 실적 서프라이즈 판단 로직을 직접 계산할 수 있는 API입니다.

3. 발표 후 데이터 확인에 좋은 Bigdata API

이미 발표된 실적을 분석하려면 Bigdata의 Earnings Surprises API도 사용할 수 있습니다.

이 API는 다음 데이터를 제공합니다.

• reporting_date
• eps_actual
• eps_estimated
• revenue_actual
• revenue_estimated
• surprise percentage

예를 들어 실제 EPS가 2.31이고 예상 EPS가 2.15라면 약 +7.4% 서프라이즈로 계산됩니다.

따라서

• 백테스트
• 실적 이벤트 분석
• 서프라이즈 기반 전략

같은 용도로 활용하기 좋습니다.

4. 대안 데이터 소스: API Ninjas와 StockFit

추가적인 옵션으로는 다음 서비스도 있습니다.

API Ninjas

이 API는

• 과거 실적 결과
• 향후 실적 발표 일정

을 모두 제공하는 Earnings Calendar 인터페이스를 제공합니다.

StockFit

StockFit API는 실적 데이터 파이프라인을 비교적 폭넓게 제공합니다.

예를 들어

• upcoming earnings calendar
• ticker별 earnings date 조회
• earnings snapshot
• EPS history

같은 기능을 제공합니다.

여러 종목을 한 번에 조회하거나 대시보드를 만들 때 활용할 수 있습니다.

트레이딩 시스템에서의 데이터 구조 예시

실제 신호 트리거 프로그램에 붙일 때는 보통 다음과 같은 컬럼 구조를 사용합니다.

판정 로직 예시:

이렇게 하면 신호 리스트에서 다음처럼 표시할 수 있습니다.

• 5‑12 장전 발표 예정
• 5‑12 장후 발표 예정
• 실적 상회
• 실적 하회

한 가지 주의할 점: 발표 시간 데이터

많은 트레이딩 시스템에서 중요한 정보는 바로

• 장 전 발표 (Before Market Open)
• 장 후 발표 (After Market Close)

같은 발표 세션 정보입니다.

하지만 현재 문서로 확인 가능한 대부분의 API는

• earnings calendar
• EPS actual / estimate
• revenue
• surprise

등은 명확히 제공하지만 항상 장 전·장 후 정보를 제공하는지 여부는 API마다 다릅니다.

따라서 실제 시스템에 붙이기 전에 여러 종목을 샘플 호출해서 필드를 확인하는 과정이 필요합니다.

정리

자동 매매나 알파 신호 시스템에서 실적 이벤트를 붙이려면 보통 다음 구조가 가장 안정적입니다.

1. OpenBB로 실적 캘린더 데이터 수집
2. AInvest 또는 Bigdata로 실제 EPS vs 예상 EPS 비교
3. 프로그램에서 beat / miss 판정 로직 실행

이 조합이면

• 발표 전 → 일정 + 발표 시점 표시
• 발표 후 → 예상 대비 결과 자동 판단

까지 대부분의 요구를 충족할 수 있습니다.

또한 필요하다면 API Ninjas나 StockFit 같은 데이터 소스를 보조 데이터 공급원으로 사용할 수도 있습니다.