KIS API가 '체결됐다'고 해도 믿지 마라: phantom-fill과 KIS-truth 재검증

매도 주문 API가 성공 응답을 반환했다. 그런데 실제 체결이 되지 않았고, 시스템은 이미 체결로 기록했다. KIS API 응답과 실제 체결 사이의 간극, 그리고 이를 방어하는 KIS-truth 재검증 패턴을 정리했다.

September 2, 2026 · 3 분

연결 타임아웃 60초가 만든 요청 적체: httpx와 KIS API의 함정

KIS API 클라이언트에 connect timeout을 60초로 설정했더니, 연결이 느려지는 순간 요청이 수십 개 쌓였다. 타임아웃을 길게 잡을수록 안전하다는 착각이 만든 사고다.

August 26, 2026 · 3 분

KIS API 개장 직후가 위험한 이유: 블랙홀 창과 서킷 브레이커 3상태 패턴

KIS API는 개장 직후 09:00~09:05 KST에 연결 불안정 구간이 존재한다. 이 구간에서 2-상태 서킷 브레이커는 회복하지 못하고 silent block에 빠진다. CLOSED/OPEN/HALF_OPEN 3-상태 서킷 브레이커와 에스컬레이션 open_seconds_schedule로 프로브 기반 자동 회복을 구현한 과정을 정리했다.

August 19, 2026 · 6 분