런북
전체 데스크 준비 체크리스트 및 통합 인증 테스트입니다.
데스크 준비 체크리스트
실전 운영 전에 다음 사항을 확인하세요:
API 연결
- 스테이징 엔드포인트 테스트 완료
- 프로덕션 엔드포인트 구성 완료 (사용 가능한 경우)
- 헬스 체크 엔드포인트 응답 확인
- WebSocket 연결 안정성 확인
인증
- EIP-712 서명 작동 확인
- 에이전트 권한 부여 구성 완료 (해당하는 경우)
- 논스(Nonce) 관리 구현 완료
- 서명 검증 테스트 완료
호가 시스템
- 대량 주문 제출 테스트 완료
- 주문 라이프사이클 대사(reconciliation) 검증 완료
- 체결 추적 구현 완료
- 취소 기능 테스트 완료
리스크 관리
- MMP 구성 및 테스트 완료
- 증거금 모델 이해 완료
- 티어 제한 검증 완료
- 포트폴리오 모니터링 구현 완료
모니터링
- WebSocket 피드 구독 완료
- 주문/체결 대사 자동화 완료
- 헬스 체크 구성 완료
- 알림 설정 완료
킬 스위치
- 모든 주문 취소 기능 확보
- 즉시 연결 해제 기능 확보
- 비상 절차 문서화 완료
헤징
- Hyperliquid 무기한 계약 연동 검증 완료
- 델타헤지 전략 구현 완료
- 무기한 계약 증거금 계산 이해 완료
결제
- 만기 처리 테스트 완료
- 포지션 결제 검증 완료
- 기준 가격 소스 이해 완료
통합 인증 테스트
테스트 1: 주문 제출
절차:
POST /order를 통해 단일 주문 제출- 주문 상태 확인:
ACKED→OPEN GET /orders?wallet=...에서 주문 확인- WebSocket
order_updates수신 확인
기대 결과: 주문이 성공적으로 제출되고 상태 업데이트가 수신됨
테스트 2: 대량 주문 제출
절차:
POST /bulk_order를 통해 10개 주문 제출- 모든 주문 접수 확인
- REST 및 WS를 통해 주문 상태 확인
- 서명/인증 오류가 없는지 확인
기대 결과: 모든 주문이 성공적으로 제출됨
테스트 3: 체결 추적
절차:
- 체결될 주문 제출
- WebSocket
fills채널 모니터링 - 올바른
order_id로 체결 수신 확인 GET /fills?wallet=...에서 체결 확인- 주문 상태가
FILLED로 업데이트되는지 확인
기대 결과: 체결이 올바르게 추적되고 주문 상태가 업데이트됨
테스트 4: 부분 체결 추적
절차:
- 부분 체결될 주문 제출
- WebSocket
fills채널 모니터링 (order_updates가 아님) - 부분 체결 수신 확인
order_id별로 체결을 집계하여 체결 수량 계산- 주문 상태가
OPEN으로 유지되는지 확인 (WS에서PARTIALLY_FILLED가 아님)
기대 결과: 부분 체결이 fills 채널을 통해 추적되고 주문 상태가 올바름
테스트 5: 주문 취소
절차:
POST /order를 통해 주문 제출DELETE /order를 통해 주문 취소- 주문 상태 확인:
CANCELED - WebSocket
order_updates수신 확인
기대 결과: 주문이 성공적으로 취소되고 상태 업데이트가 수신됨
테스트 6: MMP 트리거
절차:
POST /mmp-config를 통해 MMP 구성- MMP가 활성화된 주문 제출
- 한도 초과로 MMP 트리거
- MMP 사유로 주문이 취소되는지 확인
- 다른 MMP 활성화 주문도 취소되는지 확인
기대 결과: MMP가 올바르게 트리거되고 주문이 취소됨
테스트 7: 증거금 거부
절차:
- 증거금을 초과하는 주문 제출
- 'Insufficient margin' 사유로 주문이 거부되는지 확인
- 거부 사유에 필요 금액, 가용 금액, 부족 금액이 포함되는지 확인
- 주문 상태 확인:
REJECTED
기대 결과: 명확한 사유와 함께 주문이 거부됨
테스트 8: 티어 제한
절차:
- 롱 전용(long-only) 접근으로 구성된 지갑 사용
- 롱 포지션 없이 매도 주문 제출 시도
- 티어 사유로 주문이 거부되는지 확인
- 매수 주문 제출 (성공해야 함)
- 청산을 위한 매도 주문 제출 (성공해야 함)
기대 결과: 티어 제한이 올바르게 적용됨
테스트 9: WebSocket 재연결
절차:
- WebSocket 연결
- 채널 구독
- WebSocket 연결 해제
- 지수 백오프(exponential backoff)로 재연결
- 채널 재구독
- REST 폴링으로 누락된 업데이트 보완
기대 결과: 재연결이 정상 작동하고 상태가 복구됨
테스트 10: 포트폴리오 대사
절차:
- 주문 제출 및 체결
GET /portfolio?wallet=...을 통해 포트폴리오 확인- 포지션이 체결 내역과 일치하는지 확인
- 증거금 사용량이 올바른지 확인
- WebSocket
portfolio업데이트와 대사
기대 결과: 포트폴리오 상태가 정확하고 대사가 성공적으로 완료됨
프로덕션 준비
프로덕션 전 체크리스트
- 모든 통합 테스트 통과
- 모니터링 및 알림 구성 완료
- 킬 스위치 테스트 완료
- 비상 절차 문서화 완료
- 팀 인시던트 대응 교육 완료
- 지원 연락처 확보 완료
실전 운영 체크리스트
- 스테이징 환경 전체 테스트 완료
- 프로덕션 엔드포인트 검증 완료
- 모니터링 대시보드 준비 완료
- 알림 구성 완료
- 팀 온콜(on-call) 일정 수립 완료
- 문서 검토 완료
참고 자료
- 퀵스타트: Quickstart
- API 레퍼런스: REST API
- 오류 및 거부: Errors
- 인시던트 플레이북: Incidents