이 페이지는 자동 번역되었습니다. 영어 원문이 정본입니다. 영어로 읽기 →
메인 콘텐츠로 건너뛰기

런북

전체 데스크 준비 체크리스트와 연동 인증 테스트입니다.

데스크 준비 체크리스트​

실거래를 개시하기 전에 다음 항목을 확인하십시오.

API 연결​

  • 프로덕션 엔드포인트 설정 완료
  • 헬스 체크 엔드포인트 응답 확인
  • WebSocket 연결 안정성 확인

인증​

  • EIP-712 서명 정상 동작
  • 에이전트 권한 설정 완료 (해당하는 경우)
  • 논스(nonce) 관리 구현 완료
  • 서명 검증 테스트 완료

호가 제시 시스템​

  • 일괄 주문 제출 테스트 완료
  • 주문 수명주기 대사 검증 완료
  • 체결 추적 구현 완료
  • 취소 기능 테스트 완료

리스크 통제​

  • MMP 설정 및 테스트 완료
  • 증거금 모델 이해
  • 티어 제한 검증 완료
  • 포트폴리오 모니터링 구현 완료

모니터링​

  • WebSocket 피드 구독 완료
  • 주문/체결 대사 자동화 완료
  • 헬스 체크 설정 완료
  • 알림 설정 완료

킬 스위치​

  • 전체 주문 취소 가능
  • 즉시 연결 해제 가능
  • 비상 절차 문서화 완료

헤징​

  • Hyperliquid 퍼프 연동 검증 완료
  • 델타헤지 전략 구현 완료
  • 퍼프 증거금 계산 방식 이해

결제​

  • 만기 처리 테스트 완료
  • 포지션 결제 검증 완료
  • 기준 가격 출처 이해

연동 인증 테스트​

테스트 1: 주문 제출​

절차:

  1. POST /order로 단일 주문을 제출합니다
  2. 주문 응답 상태가 ACKED 또는 OPEN인지 확인합니다
  3. GET /orders?wallet=...에 주문이 표시되는지 확인합니다
  4. WebSocket order_updates 수신 여부를 확인합니다

기대 결과: 주문이 정상적으로 제출되고 상태 업데이트가 수신됩니다

테스트 2: 일괄 주문 제출​

절차:

  1. POST /bulk_order로 주문 10건을 제출합니다
  2. 모든 주문이 접수되었는지 확인합니다
  3. REST와 WS로 주문 상태를 확인합니다
  4. 서명/인증 오류가 없는지 확인합니다

기대 결과: 모든 주문이 정상적으로 제출됩니다

테스트 3: 체결 추적​

절차:

  1. 체결될 주문을 제출합니다
  2. WebSocket fills 채널을 모니터링합니다
  3. 올바른 order_id로 체결이 수신되는지 확인합니다
  4. GET /fills?wallet=...에 체결이 표시되는지 확인합니다
  5. 주문 상태가 FILLED로 업데이트되는지 확인합니다

기대 결과: 체결이 정확히 추적되고 주문 상태가 업데이트됩니다

테스트 4: 부분 체결 추적​

절차:

  1. 부분 체결될 주문을 제출합니다
  2. WebSocket fills 및 order_updates 채널을 모니터링합니다
  3. 부분 체결이 fills로 수신되는지 확인합니다
  4. order_updates가 누적 filled_size와 함께 PARTIALLY_FILLED를 보고하는지 확인합니다
  5. order_id별로 체결을 합산하여 합계가 filled_size와 일치하는지 확인합니다

기대 결과: fills에는 체결별 수량이, order_updates에는 누적 체결 수량이 표시됩니다

테스트 5: 주문 취소​

절차:

  1. POST /order로 주문을 제출합니다
  2. DELETE /order로 주문을 취소합니다
  3. 주문 상태가 CANCELED인지 확인합니다
  4. WebSocket order_updates 수신 여부를 확인합니다

기대 결과: 주문이 정상적으로 취소되고 상태 업데이트가 수신됩니다

테스트 6: MMP 발동​

절차:

  1. 서명된 POST /mmp-config로 MMP를 설정합니다. 클라이언트가 즉시 프로젝션을 조회할 경우 X-Hypercall-Fence-Wait: 1을 함께 보내고, 반환된 X-Hypercall-Fence 값을 보관합니다.
  2. MMP가 활성화된 주문을 제출합니다
  3. 한도를 초과하여 MMP를 발동시킵니다
  4. 주문이 MMP 사유로 취소되었는지 확인합니다
  5. MMP가 활성화된 다른 주문도 취소되었는지 확인합니다

기대 결과: MMP가 정상적으로 발동되고 주문이 취소됩니다

MMP 설정 조회에도 인증이 필요합니다. GetMmpConfig에 서명한 뒤 만기 시각과 서명을 각각 X-Hypercall-Expires-At-Ms 및 X-Hypercall-Signature 헤더로 전송하십시오. 쓰기 응답의 X-Hypercall-Fence 값을 이 GET 요청에 그대로 포함하면 해당 커밋된 설정이 반영될 때까지 대기합니다. X-Hypercall-Fence-Wait: 1 없이 보낸 쓰기 요청은 의도적으로 펜스 헤더를 반환하지 않습니다.

테스트 7: 증거금 부족 거부​

절차:

  1. 증거금을 초과하는 주문을 제출합니다
  2. 주문이 'Insufficient margin' 사유로 거부되는지 확인합니다
  3. 거부 사유에 요구 증거금, 자산가치(equity), 부족액이 포함되어 있는지 확인합니다
  4. 주문 상태가 REJECTED인지 확인합니다

기대 결과: 명확한 사유와 함께 주문이 거부됩니다

테스트 8: 티어 제한​

절차:

  1. 커버드 매도만 허용되는 티어의 지갑을 사용합니다 (GET /risk/limits?wallet=...로 확인)
  2. 롱 포지션 없이 매도 주문 제출을 시도합니다
  3. 주문이 티어 사유로 거부되는지 확인합니다
  4. 매수 주문을 제출합니다 (성공해야 함)
  5. 포지션 청산을 위한 매도 주문을 제출합니다 (성공해야 함)

기대 결과: 티어 제한이 올바르게 적용됩니다

테스트 9: WebSocket 재연결​

절차:

  1. WebSocket에 연결합니다
  2. 채널을 구독합니다
  3. WebSocket 연결을 끊습니다
  4. 지수 백오프로 재연결합니다
  5. 채널을 다시 구독합니다
  6. REST를 폴링하여 놓친 업데이트를 따라잡습니다

기대 결과: 재연결이 정상 동작하고 상태가 복구됩니다

테스트 10: 포트폴리오 대사​

절차:

  1. 주문을 제출하고 체결시킵니다
  2. GET /portfolio?wallet=...로 포트폴리오를 확인합니다
  3. 포지션이 체결 내역과 일치하는지 확인합니다
  4. 증거금 사용량이 정확한지 확인합니다
  5. WebSocket portfolio 업데이트와 대사합니다

기대 결과: 포트폴리오 상태가 정확하고 대사가 성공합니다

프로덕션 준비​

프로덕션 전 체크리스트​

  • 모든 연동 테스트 통과
  • 모니터링 및 알림 설정 완료
  • 킬 스위치 테스트 완료
  • 비상 절차 문서화 완료
  • 장애 대응 팀 교육 완료
  • 지원 연락처 확인 완료

실거래 개시 체크리스트​

  • 프로덕션에서 소규모 수량으로 인증 테스트 통과
  • 프로덕션 엔드포인트 검증 완료
  • 모니터링 대시보드 준비 완료
  • 알림 설정 완료
  • 팀 온콜 일정 수립 완료
  • 문서 검토 완료

참고 자료​

최종 업데이트: