Wallets
The fractrade platform offers you to execute the trades of your agents fully automated. Therefore, you can either run the local execution client which is available on GitHub and connect it to the agents websocket, or you can configure one or multiple execution wallets.
The easiest and fastest way is setting up one or multiple execution wallets and configure your agents to use them for trade execution.
That way, you do not have to run your own infrastructure and the fractrade platform handles everything automatically for you. The downside of this approach is, that the platform needs access to your Hyperliquid API wallet key. This key does not have any withdrawal permissions for funds but can only execute trades on your behalf.
This section explains in detail, how to configure execution wallets.
Important: For security reasons, we accept only Hyperliquid API wallets! These do not have any withdrawal permissions for your funds, but can only execute trades on your behalf!
Setting up a new Hyperliquid API wallet
Hyperliquid supports API wallets, which can sign transactions on behalf of your main wallet. These have a separate public address and private key. These API wallets can execute transactions on behalf of your main wallet, where you authorized it.
It's important to notice, that when you query the blockchain for any information, you would still use the main wallets public address. The API wallet is only used for transaction signing and can have a limited number of days when it's valid.
Go to https://app.hyperliquid.xyz/API and connect with the wallet you want to use. This might be your normal trading wallet or a separate one for testing purposes.
Then give your new API wallet a name and just press generate, to generate a new API wallet address.
Last step is to press the Authorize API Wallet button.
This will show you a private key for that newly generated API wallet. This key is generated randomly and will be shown only once. So make sure to save it, as you will need it later for your fractrade configuration.
In case you lose this key, you can generate a new one any time and remove the old one.
This newly generated private key is required for the next step, where you setup the wallet in the fractrade platform.
Setting up new wallets in fractrade
Go to "Wallets" in the main menu and press "New Wallet". Right now we support only Hyperliquid wallets but in the future other blockchains might be supported as well.
In the wallet configuration screen, you can set the following values:
Name: This is for your internal overview only. We suggest a naming based on the strategy you plan to use.
Address: This is the public address of the Hyperliquid wallet. Important: This is not the address of your API wallet.
Blockchain: For now, only Hyperliquid is available
Private Key: This is the private key from your authorized API wallet, which you generated earlier. Do never enter your main wallets private key here or anywhere else! The API wallet key will be stored encrypted in a way, that the frontend can not recover or display it again. If you lose your key, generate a new one in Hyperliquid.
After you create the new wallet, you can configure your agent to use that wallet. Therefore, go to the agent settings, by pressing the clog icon in the agents overview and then configure the execution wallet dropdown as shown in the image below.
After you saved the settings, all actions of this agent will be executed on this wallet.
Hints and notes
During our early testing stage, the funds you can manage with your execution wallet is limited to 5,000 USDC. If your balance passes this threshold, you will get a notification and the agent will stop working. We will eventually raise this limit. If you plan to use the platform with bigger amounts, use the local execution client, which is unlimited.
We recommend setting up multiple execution wallets for multiple agents or strategies. That way you can clearly track your results of various strategies, and separating funds always has the benefits of reducing the risks caused by mismanaging one of those wallets.
Last updated