> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-it/perp-dex/hyperliquid/come-connettersi.md).

# Come connettersi

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

{% hint style="info" %}
Per l'approvazione manuale delle commissioni del builder usa il nostro [strumento](https://goodcrypto.app/hype/builder-fees) come descritto di seguito. Lo strumento di Hyperdash mostrato nel video era stato dismesso
{% endhint %}

### Connettiti automaticamente con MetaMask

Se controlli il tuo account Hyperliquid con MetaMask, puoi collegarlo a goodcryptoX in soli 3 clic.

In caso contrario, puoi seguire il percorso di [configurazione manuale](#manual-setup) oppure aggiungere a MetaMask il wallet che controlla il tuo account Hyperliquid e procedere come segue.

{% stepper %}
{% step %}
Nel nostro [**web app**](https://app.goodcrypto.app) vai a:

```
Impostazioni -> Exchange -> Hyperliquid
```

{% endstep %}

{% step %}
Clicca su "Connettiti con MetaMask":

<figure><img src="/files/43db65d6e28a6118508b76ec112af029306eda02" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Seleziona il wallet che controlla il tuo account Hyperliquid e clicca su "Connetti":

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

{% step %}
Ora genereremo un wallet API e lo registreremo con Hyperliquid. In MetaMask fai "Conferma" per firmare la transazione (nessun gas richiesto):

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

Nel caso improbabile in cui tu abbia già il numero massimo di wallet API registrati su Hyperliquid (3), ti chiederemo quale vuoi sostituire e ne registreremo uno nuovo al suo posto.
{% endstep %}

{% step %}
Ti verrà quindi chiesto di firmare la transazione per approvare il nostro [builder fee](/goodcryptox-it/perp-dex/hyperliquid/commissioni-del-builder.md). Clicca su "Conferma" per procedere (nessun gas richiesto):

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

Il tuo wallet API verrà ora salvato nel nostro archivio sicuro. Una volta che lo stato della tua connessione diventa "**OK**" - hai finito!

Ora puoi vedere l'indirizzo e il nome del tuo wallet API che puoi usare per identificarlo nell'interfaccia dell'exchange, così come la sua data di scadenza:

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

I wallet API di Hyperliquid scadono ogni 6 mesi. Prima che scada, ti avviseremo e potrai sostituire senza problemi il tuo wallet API attuale con uno nuovo usando il tuo wallet MetaMask.

### Configurazione manuale

Se il wallet che usi per controllare il tuo account Hyperliquid non è MetaMask, puoi configurare manualmente la connessione con goodcryptoX.

{% stepper %}
{% step %}

#### Crea wallet API

Collega il tuo wallet a Hyperliquid. \
Vai a `Altro -> API`. \
Scegli un nome per il tuo wallet API (ad es. goodcryptoX), clicca su "Genera" l'indirizzo del wallet API e poi su "Autorizza wallet API":

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

Vedrai quindi un pop-up con la chiave privata del tuo wallet API - copiala, ti servirà per aggiungerla in seguito a goodcryptoX - non vedrai più questa chiave. Clicca anche su "MAX" nel campo "Giorni validi" - imposterà la scadenza del tuo wallet a 6 mesi (altrimenti scadrà tra 90 giorni):

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

Quando sei pronto, clicca su "Autorizza" e firma la transazione con il tuo wallet (nessun gas richiesto).
{% endstep %}

{% step %}

### Approva il builder fee

Per poter fare trading con goodcryptoX su Hyperliquid devi permetterci di [addebitare commissioni](/goodcryptox-it/perp-dex/hyperliquid/commissioni-del-builder.md) sulle tue operazioni. Hyperliquid non espone questa funzionalità nell'interfaccia, quindi abbiamo creato un [strumento](https://goodcrypto.app/hype/builder-fees) dedicato a questo.

Vai al nostro [strumento di gestione del builder fee](https://goodcrypto.app/hype/builder-fees) e collega il wallet che controlla il tuo account Hyperliquid:

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

Una volta connesso, clicca su Approva il builder fee di goodcryptoX e firma la transazione con il tuo wallet:&#x20;

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

> Anche se approvi un builder fee massimo dell'1%, questo approva solo una commissione futures dello 0,1% (imposta da Hyperliquid). L'entrata unificata dell'1% è una limitazione visiva nell'implementazione di questa funzionalità da parte di Hyperliquid

{% hint style="info" %}
Se hai creato il tuo account Hyperliquid usando **l'email**, dovrai esportare il tuo wallet in MetaMask (o in un altro wallet) prima di poter approvare i builder fee.

Vai su Impostazioni nell'interfaccia di Hyperliquid e seleziona "Esporta wallet email"
{% endhint %}
{% endstep %}

{% step %}

### Aggiungi il wallet API a goodcryptoX:

Nella nostra app (web o mobile), vai a:

```
Impostazioni -> Exchange -> Hyperliquid -> Aggiungi wallet API manualmente
```

Aggiungi l'indirizzo del wallet che controlla il tuo account Hyperliquid (NON l'indirizzo del tuo wallet API) a "Indirizzo account Hyperliquid".\
Aggiungi la chiave privata del wallet API che hai creato (NON la chiave privata del tuo wallet principale) a "Chiave privata del wallet API" e clicca su "Salva e valida":

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

Il tuo wallet API verrà ora salvato nel nostro archivio sicuro. Una volta che lo stato della tua connessione diventa "**OK**" - hai finito!

Ora puoi vedere l'indirizzo e il nome del tuo wallet API, così come la sua data di scadenza:

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

Prima che scada, ti avviseremo in anticipo così avrai abbastanza tempo per sostituirlo con uno nuovo.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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-it/perp-dex/hyperliquid/come-connettersi.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.