# 연결 방법

{% embed url="<https://youtu.be/dCKlpi8v738>" %}

{% hint style="info" %}
수동 빌더 수수료 승인을 위해서는 아래에 설명된 우리의 맞춤 [도구를](https://goodcrypto.app/hype/builder-fees) 사용하세요. 영상에 표시된 Hyperdash의 도구는 이미 서비스가 종료되었습니다
{% endhint %}

### MetaMask에 자동으로 연결

MetaMask로 Hyperliquid 계정을 관리하고 있다면, 단 3번의 클릭으로 goodcryptoX에 연결할 수 있습니다.

그렇지 않다면 - 아래의 [수동 설정](#manual-setup) 경로를 따르거나 Hyperliquid 계정을 제어하는 지갑을 MetaMask에 추가한 뒤 다음 단계를 진행하세요.

{% stepper %}
{% step %}
우리의 [**웹 앱에서**](https://app.goodcrypto.app) 다음으로 이동하세요:

```
설정 -> 거래소 -> Hyperliquid
```

{% endstep %}

{% step %}
"MetaMask에 연결"을 클릭하세요:

<figure><img src="/files/4ce3e5aa71f6d8cfb94efee92c013ba02b8ffb44" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Hyperliquid 계정을 제어하는 지갑을 선택하고 "연결"을 클릭하세요:

<figure><img src="/files/00fcfd3da5541039f099113c168de2990d68ed65" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
이제 API 지갑을 생성하여 Hyperliquid에 등록합니다. 거래에 서명하려면 Metamask에서 "확인"을 클릭하세요(가스 비용 필요 없음):

<figure><img src="/files/4e84fc25cba4155819eaf4f5cf276e115232fb54" alt="" width="375"><figcaption></figcaption></figure>

드물게 Hyperliquid에 이미 등록된 API 지갑의 최대 수(3개)에 도달한 경우, 어떤 지갑을 교체할지 묻고 그 자리에 새 지갑을 등록합니다.
{% endstep %}

{% step %}
그 다음 우리의 [빌더 수수료](/goodcryptox-ko/perp-dex-1/hyperliquid/builder-fees.md)를 승인하기 위해 거래에 서명하라는 요청을 받게 됩니다. 진행하려면 "확인"을 클릭하세요(가스 비용 필요 없음):

<figure><img src="/files/e0a57958a3afd36e80b136aa7cf861541dda6adb" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

이제 API 지갑이 안전한 저장소에 저장됩니다. 연결 상태가 "**OK**"로 바뀌면 모든 설정이 완료된 것입니다!

이제 API 지갑의 주소와 이름을 볼 수 있으며, 거래소 인터페이스에서 이를 식별하는 데 사용할 수 있고 만료일도 확인할 수 있습니다:

<figure><img src="/files/cb9b5f0330baba513e61c9176abd0b73cc7010b8" alt=""><figcaption></figcaption></figure>

Hyperliquid의 API 지갑은 6개월마다 만료됩니다. 만료되기 전에 미리 알려드리며, MetaMask 지갑을 사용해 현재 API 지갑을 새 지갑으로 원활하게 교체할 수 있습니다.

### 수동 설정

Hyperliquid 계정을 제어하는 데 사용하는 지갑이 MetaMask가 아닌 경우, goodcryptoX와의 연결을 수동으로 설정할 수 있습니다.

{% stepper %}
{% step %}

#### API 지갑 생성

지갑을 Hyperliquid에 연결하세요. \
다음으로 이동: `더보기 -> API`. \
API 지갑의 이름을 정하고(예: goodcryptoX), "생성"을 클릭해 API 지갑 주소를 만든 다음 - "API 지갑 승인"을 클릭하세요:

<figure><img src="/files/1d4d48284d937322c96237e6d1f59ebf8093501c" alt="" width="563"><figcaption></figcaption></figure>

그러면 API 지갑의 개인 키가 포함된 팝업이 표시됩니다. 이를 복사해 두세요. 나중에 goodcryptoX에 추가해야 하며, 이 키는 다시 볼 수 없습니다. 또한 "유효 일수" 항목의 "MAX"를 클릭하세요 - 그러면 지갑 만료 기간이 6개월로 설정됩니다(그렇지 않으면 90일 후 만료됩니다):

<figure><img src="/files/d371a054161a33e62e6cfa25acab262dd872f109" alt="" width="375"><figcaption></figcaption></figure>

준비가 되면 "승인"을 클릭하고 지갑으로 거래에 서명하세요(가스 비용 필요 없음).
{% endstep %}

{% step %}

### 빌더 수수료 승인

Hyperliquid에서 goodcryptoX로 거래하려면 우리가 [수수료를 부과할 수 있도록](/goodcryptox-ko/perp-dex-1/hyperliquid/builder-fees.md) 허용해야 합니다. Hyperliquid는 인터페이스에서 이 기능을 제공하지 않기 때문에, 이를 위해 전용 [도구를](https://goodcrypto.app/hype/builder-fees) 을 구축했습니다.

우리의 [빌더 수수료 관리 도구](https://goodcrypto.app/hype/builder-fees) 로 이동해 Hyperliquid 계정을 제어하는 지갑을 연결하세요:

<figure><img src="/files/f797c93d584fc9a01f7ffb7b84e01e6303775cd7" alt="" width="563"><figcaption></figcaption></figure>

연결되면 goodcryptoX 빌더 수수료 승인를 클릭하고 지갑으로 거래에 서명하세요:&#x20;

<figure><img src="/files/80b89aa7f2b7d9c38b30c8014dd9c03e1529f223" alt="" width="563"><figcaption></figcaption></figure>

> 1%의 최대 빌더 수수료를 승인하더라도, 실제로는 0.1%의 선물 수수료만 승인됩니다(Hyperliquid에서 적용). 통합된 1% 표시는 이 기능 구현에서 Hyperliquid의 시각적 제한입니다

{% hint style="info" %}
Hyperliquid 계정을 생성할 때 **이메일**을 사용했다면, 빌더 수수료를 승인하기 전에 지갑을 MetaMask(또는 다른 지갑)로 내보내야 합니다.

Hyperliquid 인터페이스의 설정으로 이동하여 “이메일 지갑 내보내기”를 선택하세요
{% endhint %}
{% endstep %}

{% step %}

### goodcryptoX에 API 지갑 추가:

우리 앱(웹 또는 모바일)에서 다음으로 이동하세요:

```
설정 -> 거래소 -> Hyperliquid -> API 지갑 수동 추가
```

Hyperliquid 계정을 제어하는 지갑의 주소(API 지갑 주소가 아님)를 "Hyperliquid 계정 주소"에 추가하세요.\
생성한 API 지갑의 개인 키(메인 지갑의 개인 키가 아님)를 "API 지갑 개인 키"에 추가한 뒤 "저장 및 검증"을 클릭하세요:

<figure><img src="/files/b5d5c68424926b95f88f7ba2f6ac4ec628fb38ad" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

이제 API 지갑이 안전한 저장소에 저장됩니다. 연결 상태가 "**OK**"로 바뀌면 모든 설정이 완료된 것입니다!

이제 API 지갑의 주소와 이름, 그리고 만료일을 볼 수 있습니다:

<figure><img src="/files/cb9b5f0330baba513e61c9176abd0b73cc7010b8" alt=""><figcaption></figcaption></figure>

만료되기 전에 미리 알려드려 교체할 새 지갑을 준비할 충분한 시간을 드리겠습니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.goodcrypto.app/goodcryptox-ko/perp-dex-1/hyperliquid/how-to-connect.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.