문서
무엇을 하고 싶으신가요?
Hyperliquid 연결
Hyperliquid는 API 지갑을 사용합니다. 메인 계정이 승인한 위임 키로, 주문은 할 수 있지만 출금은 할 수 없습니다. MyLiquidBot에는 메인 계정 주소(자금이 있는 곳)와 API 지갑 개인 키가 필요합니다. 메인 지갑의 개인 키와 시드 문구는 절대 필요하지 않습니다.
이메일이나 소셜 로그인으로 만든 Hyperliquid 계정은 호환되지 않습니다. 본인 지갑(MetaMask, Rabby, Coinbase Wallet 등)으로 만든 계정을 사용하세요.
연결 추가에서 Hyperliquid를 선택하고 빠른 연결을 그대로 두세요. 브라우저 지갑 연결 또는 WalletConnect를 누르고 Hyperliquid 계정의 메인 지갑으로 서명하세요. MyLiquidBot이 API 지갑을 만들고 Hyperliquid가 이를 계정에 연결하며, 마법사는 거래 활성화로 넘어갑니다. 자금 이동과 가스 비용이 없고 키는 절대 출금할 수 없습니다. 약 180일 동안 유효하며, 만료 전에 관리 → API 지갑에서 서명 한 번으로 갱신하세요. 직접 만들려면 API 키 붙여넣기를 선택하고 1부와 2부를 따르세요.
1부 — Hyperliquid에서 API 지갑 만들기
메인 지갑으로 Hyperliquid 열기
app.hyperliquid.xyz로 이동하여 계정을 소유하고 자금을 보유한 지갑을 연결하고, USDC가 입금되어 있는지 확인하세요.
API 페이지를 열고 API 지갑 생성
Hyperliquid 메뉴에서 API 페이지를 열고, API 지갑에 이름을 지정한 뒤 생성하고 메인 지갑으로 승인하세요. Hyperliquid는 API 지갑의 개인 키를 한 번만 보여 줍니다. 비밀번호 관리자에 복사해 두세요.
유효 기간에 유의하세요
Hyperliquid가 유효 기간을 묻는다면 적합한 기간을 선택하고 기억해 두세요. API 지갑이 만료되면 연결이 거래를 중단하므로 새로 만들어 연결을 편집해야 합니다.
2부 — MyLiquidBot에 연결 추가
계정 → 거래소 → 연결 추가로 이동하여 Hyperliquid를 선택하고, 계정이 본인 지갑으로 만들어졌음을 확인한 뒤 다음을 입력하세요:
| MyLiquidBot의 필드 | 입력할 내용 |
|---|---|
| 연결 이름 | 3자 이상의 임의 라벨. 예: Hyperliquid Main. |
| Wallet Address | 메인 계정 주소(0x…) — Hyperliquid에서 자금을 보유한 지갑입니다. API 지갑 주소가 아닙니다. |
| Hyperliquid API Wallet - Private Key | API 지갑을 만들 때 한 번 표시된 개인 키(16진수 64자, 0x 유무 무관). |
| Vault Address (선택) | 직접 관리하는 Hyperliquid 볼트를 거래할 때만 입력합니다. 대부분의 사용자는 비워 둡니다. |
| API URL (선택) | 비워 두세요. |
저장 및 확인을 누르세요. MyLiquidBot은 키가 해당 계정에 승인된 유효한 API 지갑인지 확인합니다.
3부 — 거래 활성화(Builder Fee)
메인 지갑 연결
활성화 단계(또는 나중에 관리 → 거래 활성화)에서 지갑 연결을 누르고 브라우저 지갑 또는 WalletConnect를 선택하세요. 연결에 저장된 것과 같은 메인 지갑을 사용하세요.
거래 활성화를 누르고 서명
지갑이 서명을 요청합니다. 트랜잭션이 아니며 가스가 들지 않고 자금을 이동하지 않으며 출금을 절대 허용하지 않습니다. Hyperliquid는 계정에 이미 입금이 있는 경우에만 승인을 받아들입니다.
상태 확인
패널에 거래 활성이 표시되면 봇과 수동 주문이 연결을 사용할 수 있습니다. 업데이트 필요가 표시되면 다시 활성화하세요. 동기화가 대기 중이면 고급 → 동기화 재시도를 여세요.
Hyperliquid에서는 미리 레버리지를 설정할 필요가 없습니다. 봇 생성기와 거래 주문창이 각 시장에 대해 선택한 레버리지와 교차/격리 모드를 동기화합니다.
문제 해결
| 메시지 또는 증상 | 가능한 원인 | 해결 방법 |
|---|---|---|
| “The Hyperliquid API Wallet - Private Key does not match the wallet and is not listed as an approved API wallet for that account.” | Wallet Address가 API 지갑을 승인한 계정이 아니거나, API 지갑이 만료되었거나 제거되었습니다. | Wallet Address에 메인 계정 주소를 입력하세요. Hyperliquid의 API 페이지에서 API 지갑이 아직 목록에 있는지 확인하고, 없으면 새로 만들어 연결을 편집하세요. |
| “Invalid Hyperliquid API Wallet - Private Key format…” | 불완전한 키, 여분의 공백, 또는 키 대신 주소를 붙여넣음. | 64자 전체 개인 키를 다시 붙여넣으세요. |
| “Invalid wallet address. It must use 0x format.” | 잘못되었거나 잘린 주소. | 메인 지갑의 전체 0x… 주소를 복사하세요. |
| 잔고가 0으로 표시됨 | Wallet Address에 API 지갑 주소를 입력했거나 계정에 입금이 없습니다. | 연결을 편집하여 메인 계정 주소를 입력하고, Hyperliquid에 USDC를 입금하세요. |
| “Hyperliquid requires a deposit in this account before it accepts the approval.” | 계정이 한 번도 입금을 받은 적이 없습니다. | Hyperliquid의 해당 지갑에 USDC를 입금한 뒤 다시 활성화하세요. |
| “Open the same wallet saved in the connection” | 지갑에서 다른 계정이 선택되어 있습니다. | 지갑을 연결에 저장된 메인 계정으로 전환하고 다시 서명하세요. |
| 거래가 되다가 중단됨 | API 지갑이 만료되었거나 취소되었습니다. | 새 API 지갑을 만들고 새 키로 연결을 편집한 뒤 저장하세요. |