Hyperliquid를 Tarvis에 연결하기
Hyperliquid에서 거래 전용 키를 만들어 Tarvis에 추가하세요. 몇 분이면 되고, 이 키로는 출금할 수 없어요.
- 지갑 주소
- 자금이 들어 있는 내 Hyperliquid 계정의 주소예요. 공개 주소이고 0x로 시작해요. 공유해도 안전해요.
- API 지갑 개인 키
- 아래에서 만드는 거래 전용 키예요. 주문을 넣고 취소할 수는 있지만 출금은 못 해요.
-
API 페이지 열기
Hyperliquid에서 More → API로 이동하세요.
-
이름을 정하고 Generate 클릭
my_tarvis_key같은 이름을 입력하고 Generate를 클릭하세요. Hyperliquid가 새 에이전트 지갑 주소를 채워 줘요. -
Authorize API Wallet 클릭
확인 창이 열려요.
-
기간을 고르고 승인하기
유효 기간은 MAX를 눌러 두면 한동안 다시 만들 필요가 없어요. Authorize를 클릭하기 전에 Private Key를 복사하세요. Hyperliquid는 이 키를 다시 보여주지 않아요.
-
계정 페이지에서 계정 연결 클릭
상단 바의 스위치가 실전인지 확인하세요. "메인" 같은 이름을 입력하고 Hyperliquid를 고르세요.
-
두 값 붙여 넣기
지갑 주소는 입금할 때 쓴 것과 같은 내 Hyperliquid 계정 주소예요. API 지갑 개인 키는 방금 복사한 키예요.
-
연결 클릭
Tarvis는 키를 저장하기 전에 Hyperliquid에 확인하고, 저장할 때는 암호화해요.
거래 시작하기
이제 계정이 계정 페이지에 나타나요. 거래 스타일을 고르고 위험 설정을 살펴본 뒤 시작을 누르세요.
Tarvis가 키를 거부할 때
| 보이는 메시지 | 의미 | 할 일 |
|---|---|---|
| 메인 지갑 키로 보여요 | 지갑 자체의 키를 붙여 넣었어요 | More → API에서 에이전트 키를 만드세요 |
| 아직 승인되지 않았어요 | 키는 만들었지만 승인하지 않았어요 | Hyperliquid에서 Authorize API Wallet을 클릭하세요 |
| 다른 계정에 승인된 키예요 | 주소와 키가 서로 맞지 않아요 | 키를 승인한 계정의 주소를 입력하세요 |
| 개인 키가 아니에요 | 형식이 잘못됐어요 | 0x 뒤에 16진수 64자를 붙여 넣으세요 |
키가 만료될 때
에이전트 키는 승인할 때 고른 기간 동안 유효해요. 만료가 가까워지면 계정 페이지에 키 N일 후 만료가 표시돼요. 같은 방법으로 새 키를 만들고 다시 연결을 사용하세요. 먼저 계정을 정지하세요. 거래 중에 연결을 바꾸면 실전 주문에 문제가 생길 수 있어요.