How to connect
Connect with MetaMask automatically
If you control your Hyperliquid account with MetaMask, you can connect your Hyperliquid account to goodcryptoX in just 3 clicks.
If not - you can either follow the manual setup route or add the wallet that controls your Hyperliquid account to MetaMask and proceed with the following.
In our web app go to:
Settings -> Exchanges -> HyperliquidClick "Connect with MetaMask":

Select the wallet that controls your Hyperliquid account and click "Connect":

We will now generate an API wallet and register it with Hyperliquid. "Confirm" in Metamask to sign the transaction (no gas required):

In the unlikely case you already have a maximum number of registered API wallets on Hyperliquid (3), we will ask which one do you want to replace and register a new one in its place.
You will then be asked to sign the transaction to approve our Builder fee. Click "Confirm" to proceed (no gas required):

Your API wallet will now be saved in our secure storage. Once the status of your connection turns to "OK" - you are all set!
You can now see your API wallet's address and name that you can use to identify it in the exchange's interface, as well as its expiration date:

Hyperliquid's API wallets expire every 6 months. Before it expires, we will warn you and you'll be able to seamlessly replace your current API wallet with a new one using your MetaMask wallet.
Manual setup
If the wallet you use to control your Hyperliquid account is other than MetaMask, you can setup the connection with goodcryptoX manually. Though, we strongly recommend importing that wallet to MetaMask and proceeding with the automatic route.
Create API wallet
Connect your wallet to Hyperliquid.
Go to More -> API.
Pick a name for your API wallet (e.g. goodcryptoX), click "Generate" the API wallet address and then - "Authorize API Wallet":

You will then see a pop-up with your API wallet Private Key - copy it, you will need to odd it to goodcryptoX later - you won't see this key again. Also click on the "MAX" in the "Days Valid" filed - it will set your wallet's expiry to 6 months (otherwise it will expire in 90 days):

Once ready, click "Authorize" and sign the transaction with your wallet (no gas required).
Approve Builder fee
To be able to trade with goodcryptoX on Hyperliquid you need to allow us to charge fees on your trades. Hyperliquid does not expose this functionality in the interface, so you will need to use a third-party tool for that. For example - Hyperdash.
Go to Hyperdash's Builder fee management tool and connect the wallet that controls your Hyperliquid account. Add our address to "Builder Address" field:
0xff09853a49dde85a8e7eab58abf94018fbe76116Set "Max Fee Rate" to 1% and click "Approve Builder" (no gas required):

Add API wallet to goodcryptoX:
In our app (web or mobile), go to:
Settings -> Exchanges -> Hyperliquid -> Add API wallet manuallyAdd the address of the wallet that controls your Hyperliquid account (NOT your API wallet address) to "Hyperliquid account address". Add the private key of the API wallet you created (NOT the pricate key to your main wallet) to "API wallet private key" and click "Save and Validate":

Your API wallet will now be saved in our secure storage. Once the status of your connection turns to "OK" - you are all set!
You can now see your API wallet's address and name, as well as its expiration date:

Before it expires, we will warn you beforehand so that you'll have enough time to replace it with a new one.
Last updated