SHARKRULE / 학습 가이드

Hyperliquid API 설정: 접근 권한과 보안

자동화를 연결하기 전에 Hyperliquid 계정 접근 방식을 알아보세요. 이 안내는 거래소의 설정 절차를 설명하며, 해당 거래소의 SharkRule 연결은 준비 중입니다.

SharkRule · 문서 확인일

이용 가능 여부와 계정 모드를 먼저 확인하세요

Hyperliquid 연결은 SharkRule에서 준비 중이며 현재 대시보드에서는 사용할 수 없습니다. 이 가이드는 거래소의 접근 방식과 권한을 설명합니다. 대시보드에서 연결을 제공할 때까지 인증 정보를 만들거나 공유하지 마세요.

준비된 연동은 현물 잔액이 분리된 호환 계정에서 UBTC/USDC 현물을 지원합니다. 통합 계정과 포트폴리오 마진 모드는 거부합니다. 하이퍼리퀴드는 통합 모드를 기본으로 사용할 수 있으므로 실제 계정 설정을 확인하세요. 호환성 오류를 피하려고 담보 구조를 이해하지 않은 채 변경하면 안 됩니다.

새 API 지갑을 만들고 승인하세요

  1. 직접 https://app.hyperliquid.xyz/API 를 열고 사용할 계정의 주 지갑을 연결하세요. 컴퓨터에서는 지갑 확장 프로그램이 지원하는 연결 방식을 사용합니다. 휴대전화에서는 지갑 내 브라우저나 지원되는 지갑 연결 절차를 이용하고 도메인을 확인하세요.
  2. 하이퍼리퀴드의 API 지갑 생성 기능으로 SharkRule만을 위한 새 에이전트를 만드세요. 나중에 구분할 수 있는 이름을 붙이고 다른 봇에서 쓰는 키를 재사용하지 마세요.
  3. 주 지갑에서 에이전트 주소와 승인 메시지를 읽은 뒤 올바른 계정에 승인하세요. 이 서명은 에이전트의 권한 승인입니다. SharkRule의 거래 규칙 활성화와는 별도 단계입니다.
  4. 생성된 에이전트 개인키를 안전하게 보관하고 자금이 있는 주 계정의 공개 주소를 따로 복사하세요. 계정 주소 대신 에이전트 주소를 넣으면 잔액이 없거나 잘못된 계정 결과가 표시될 수 있습니다.

에이전트 권한은 현물 거래보다 넓습니다

에이전트는 이 안내의 현물 거래쌍 이외의 거래 작업도 승인할 수 있습니다. SharkRule은 준비된 연동을 UBTC/USDC 현물 매수로 제한하지만, 거래소가 에이전트 권한을 그 거래쌍에만 제한해 주는 것은 아닙니다. 에이전트 키가 유출되면 거래 손실 위험이 있습니다.

입금과 주 지갑 관리는 별도 작업입니다. 이 연결은 주 지갑 개인키, 시드 문구, 빌더 수수료 승인이나 에이전트 주소로의 입금을 요구하지 않습니다. 에이전트를 만들었다는 이유만으로 그 주소에 자금을 보내지 마세요.

연결이 제공되면

연결이 제공되면 대시보드에 지원 계정 유형, 인증 정보 입력란, 서버 IP가 표시됩니다. 그때 안내를 따르세요. 연결 확인과 전략 승인은 별도 단계이며, 이 가이드를 읽는 것만으로 거래가 시작되지 않습니다.

주소와 승인 상태, 잔액을 확인하세요

승인 오류가 나면 해당 개인키가 승인한 에이전트의 것인지, 승인 기간이 끝났거나 삭제되지 않았는지 확인하세요. 계정 모드 오류를 주 지갑 개인키로 해결하려 해서는 안 됩니다. USDC는 호환되는 현물 잔액에 있어야 하며 무기한 선물 잔액과는 다릅니다.

주문 결과가 불확실하면 새 규칙을 만들기 전에 하이퍼리퀴드의 주문·체결 내역을 확인하세요. 키가 유출된 상황이 아니라면 결과 확인에 필요한 접근 권한을 유지합니다. 문제 설명에 에이전트 개인키를 첨부하지 마세요.

거래소에서 접근 철회하기

진행 중인 주문은 Hyperliquid에서 직접 확인하세요. 공식 설정에서 전용 API 키를 삭제하거나 API 지갑 승인을 철회하면 해당 접근 권한이 제거됩니다. 철회해도 보유 자산이 매도되거나 이미 접수된 주문이 취소되지는 않습니다. 인증 정보가 노출되었다면 즉시 철회하고 계정 활동을 확인하세요.

자주 묻는 질문

주 지갑의 개인키를 내보내야 하나요?

아니요. 별도로 승인한 에이전트 키만 사용합니다. 주 지갑 개인키는 제공하면 안 됩니다.

포트폴리오 마진 계정도 연결되나요?

준비된 연동에서는 지원하지 않습니다. 비밀 정보를 입력하기 전에 계정 호환성을 확인하고 마진 설정을 무작정 변경하지 마세요.

공식 자료와 출처

링크된 공식 문서를 바탕으로 AI의 도움을 받아 작성했습니다. 예시는 가상 상황이며 실제 계정 테스트나 수익률 비교를 수행하지 않았습니다.