연동의 핵심
화면을 연결하는 것이 아니라 서로 다른 주문·계정 모델을 변환하는 일입니다. 상품 코드, 주문 유형, 상태, 시간과 오류 의미를 먼저 맞추고 중복·누락·재연결을 시험해야 합니다.
연동 목적을 먼저 정한다
차트만 표시할지, 신호를 받을지, 주문을 양방향으로 전달할지에 따라 위험과 구현 범위가 크게 달라집니다. 자동매매 주문을 허용한다면 사용자 승인, 한도, 비상 중지와 활동 기록을 포함해야 합니다.
상품과 주문 모델 매핑
플랫폼마다 종목 코드, 소수점, 계약 크기, 주문 종류와 상태 이름이 다를 수 있습니다. 단순 문자열 변환보다 명시적인 매핑표와 버전 관리가 필요합니다.
| 영역 | 매핑할 내용 |
|---|---|
| 상품 | 심볼, 만기, 가격 단위, 수량 단위, 거래 시간 |
| 주문 | 시장가·지정가·조건부 주문과 유효 기간 |
| 상태 | 접수, 전송, 부분 체결, 체결, 취소, 거절 |
| 계정 | 잔고, 증거금, 포지션과 통화 |
중복 주문을 막는 방법
네트워크 타임아웃 뒤 같은 요청을 다시 보낼 때 중복 주문이 생길 수 있습니다. 요청별 고유 식별자, 멱등성 처리, 재시도 횟수와 최종 상태 조회 절차를 정합니다. 클라이언트가 응답을 받지 못했더라도 서버에 주문이 존재할 수 있다는 상황을 시험해야 합니다.
인증과 권한
API 키별 계정·상품·주문 권한, IP 또는 기기 제한과 만료를 설정합니다. 키 발급·교체·폐기 기록을 남기고 사용자가 비상 상황에서 자동매매를 즉시 중단할 수 있어야 합니다. 비밀키를 단말 로그나 설정 파일에 평문으로 저장하지 않습니다.
장애와 복구
연결이 끊기면 새 주문을 차단할지 대기열에 넣을지 결정합니다. 재연결 뒤 열린 주문과 포지션을 원장과 대조하고 차이가 있으면 자동으로 숨기지 말고 운영자에게 알립니다. 메시지 순서와 재처리 정책도 문서화합니다.
검수 목록
- 모든 주문 유형과 거절 사유 매핑
- 부분 체결·정정·취소와 타임아웃
- 중복 요청과 오래된 응답 처리
- 상품 만기·거래 시간·서머타임 변경
- API 키 권한·교체·비상 중지
- 재연결 뒤 주문·포지션 정합성
- 요청·응답·작업자 감사 로그
프로토콜 참고
기관·시스템 간 주문 메시지는 FIX Trading Community의 공식 자료처럼 표준 메시지와 상태 모델을 참고할 수 있습니다. 특정 플랫폼 지원 여부와 사용 권한은 각 공급사 문서와 계약을 확인해야 합니다.
적용 전 확인
이 자료는 B2B 소프트웨어 도입을 위한 일반 정보입니다. 금융투자업 인가, 고객 자금 취급, 주문 중개와 데이터 라이선스 요건은 사업 구조와 관할 지역에 따라 달라질 수 있으므로 실제 운영 전 별도 검토가 필요합니다.