Hyperliquid koppelen

Hyperliquid is een on-chain exchange: je logt in met een crypto-wallet of een e-mailadres, en je account is gekoppeld aan een walletadres. Bybot handelt op je Hyperliquid-account via een API Wallet – een aparte sleutel die orders kan plaatsen en annuleren voor je wallet. Je geld blijft op je Hyperliquid-account, en de API Wallet kan geen tegoed opnemen of overboeken. Het instellen duurt ongeveer 10 minuten.

In Bybot voeg je twee dingen toe: het adres van je hoofdwallet en de privésleutel van de API Wallet. Plak nooit de privésleutel of seedphrase van je hoofdwallet – Bybot heeft die niet nodig en weigert hem.

1. Log in bij Hyperliquid

Open app.hyperliquid.xyz en klik op “Connect”. Log in met een crypto-wallet of met een e-mailadres. Gebruik je een wallet, klik dan daarna op “Enable Trading” en onderteken het verzoek in je wallet – dat kost geen gas.

2. Stort USDC

Klik op “Deposit”, kies USDC on Arbitrum en volg de instructies op het scherm.

3. Maak de USDC beschikbaar voor spot

Bybot handelt op de spotmarkt van Hyperliquid. Doe een van de volgende dingen:

• zet je account op “Unified account” – dan dient één USDC-saldo voor zowel spot als perpetuals en is geen overboeking nodig;
• of zet in de standaardmodus USDC over van “Perps” naar “Spot”: in deze modus komen stortingen binnen op het Perps-saldo.

De modus “Portfolio margin” wordt niet ondersteund: daarin leent Hyperliquid automatisch als het saldo tekortschiet, waardoor de bot op krediet zou kunnen kopen. Bybot werkt niet met zo’n account.

4. Open de API-pagina

Open in het bovenste menu “More” en kies “API”.

5. Maak een API Wallet met een naam aan

1. Voer een naam in voor de API Wallet, bijvoorbeeld bybot, en klik op “Generate”.
2. Klik op “Authorize API Wallet”.

3. Klik in het venster “Authorize API Wallet” op “MAX” in het veld “Days Valid” – de API Wallet werkt dan de maximale periode, tot 180 dagen.
4. Kopieer de “Private Key” met de kopieerknop en bewaar hem op een veilige plek.
5. Klik op “Authorize”. Ben je ingelogd met een wallet, bevestig dan in je wallet.

6. Kopieer je walletadres

Klik rechtsboven op de knop van je account en kopieer het adres met de kopieerknop. Dit is het adres van je hoofdwallet – het adres dat Bybot nodig heeft. Gebruik niet het adres van de API Wallet uit stap 5.

7. Voeg de sleutel toe in Bybot

Open in Bybot Instellingen (“Settings”) → API-sleutels (“API Keys”) en klik op Sleutel toevoegen (“Add key”). Kies HYPERLIQUID en vul twee velden in:

Klik op Opslaan (“Save”). Bybot controleert de sleutel via de openbare gegevens van Hyperliquid: de API Wallet moet bij deze wallet horen en een naam hebben, en de accountmodus moet worden ondersteund.

8. Controleer de sleutel

Klik in de sleutellijst op ”⋯” op de Hyperliquid-kaart en kies Sleutel controleren (“Check key”). Bybot bevestigt dat de API Wallet nog aan je wallet gekoppeld is. De kolom Verloopdatum API Wallet (“API Wallet expiry”) laat zien wanneer hij verloopt.

9. Voordat je een bot aanmaakt

• Bybot verhandelt 6 paren tegen USDC: BTC, ETH, SOL, ZEC, HYPE en NEAR. BTC, ETH, SOL en ZEC zijn op Hyperliquid door Unit gewrapte munten (UBTC, UETH, USOL, UZEC); NEAR wordt verhandeld als de token ONEAR.
• Op Hyperliquid kun je één DCA-bot per paar laten draaien.
• De minimale order is 10 USDC.

Volg daarna de handleiding Een bot aanmaken.

Levensduur van de API Wallet

Je kiest bij het aanmaken hoe lang de API Wallet werkt, tot 180 dagen. Bybot herinnert je eraan voordat hij verloopt. Is hij verlopen, dan stopt de bot met handelen. Om door te gaan maak je op Hyperliquid een nieuwe API Wallet met een naam aan, verwijder je de oude sleutel in Bybot en voeg je de nieuwe toe.

Actielimiet van Hyperliquid

Hyperliquid beperkt het aantal acties – orders plaatsen en annuleren – per wallet: 10,000 om te beginnen, plus 1 actie voor elke $1 handelsvolume op de wallet. Is de limiet op, dan stopt het handelen niet, maar het gaat wel langzamer.

Bybot kan geen extra acties kopen: Hyperliquid accepteert die aankoop alleen met de handtekening van je hoofdwallet en rekent hem af bij de hoofdwallet. Is de limiet op, wacht dan tot je handelsvolume groeit of koop zelf extra acties vanuit je hoofdwallet.

Commissies en restanten

• De spotcommissie van Hyperliquid is 0.07% voor taker-orders en 0.04% voor maker-orders op het basisniveau.
• Bij een aankoop wordt de commissie ingehouden in de munt die je koopt (voor BTC in UBTC), bij een verkoop in USDC. Je ontvangt dus iets minder munten dan je hebt gekocht.
• Een restant met een waarde onder de minimale order van 10 USDC kan niet worden verkocht en blijft als dust op het account staan.

Handmatig handelen op dezelfde wallet

Handel niet handmatig in een paar waarin de bot actief is. Hyperliquid laat een wallet niet met zichzelf handelen: als je handmatige order de order van de bot raakt, annuleert Hyperliquid de order die al in het orderboek stond – vaak die van de bot. De bot ziet dat als een annulering.

Veiligheid van de sleutel

• Opnames zijn onmogelijk. Een API Wallet kan orders plaatsen en annuleren, maar geen tegoed opnemen of overboeken – Hyperliquid weigert zulke verzoeken, ook als de sleutel uitlekt.
• Plak nooit de privésleutel of seedphrase van je hoofdwallet. Bybot heeft alleen de sleutel van de API Wallet nodig en vraagt nooit om je seedphrase.
• Gebruik een aparte wallet voor de bot. De API Wallet kan op je hele Hyperliquid-account handelen, inclusief perpetuals.
• Eén wallet – één Bybot-account. Een walletadres kan maar aan één Bybot-account worden gekoppeld.
• Gebruik je de bot niet meer, stop dan je Hyperliquid-bots, verwijder de sleutel in Bybot en trek daarna de API Wallet in op app.hyperliquid.xyz → “API”. Zolang je hem niet intrekt, kan de API Wallet nog op je account handelen.

Veelvoorkomende problemen

“Hyperliquid did not confirm the key” (Hyperliquid heeft de sleutel niet bevestigd). Controleer het walletadres en de privésleutel van de API Wallet, en of de API Wallet niet verlopen is.

“This is your main wallet private key” (dit is de privésleutel van je hoofdwallet). Je hebt de sleutel van de hoofdwallet geplakt. Maak een API Wallet met een naam aan (stap 5) en plak de privésleutel daarvan.

“The API Wallet must be a named one” (de API Wallet moet een naam hebben). Maak op de API-pagina een API Wallet met een naam aan en plak de sleutel daarvan.

“This Hyperliquid account mode is not supported” (deze accountmodus van Hyperliquid wordt niet ondersteund). Het account staat op Portfolio margin. Schakel over naar Unified account of de standaardmodus.

“This Hyperliquid wallet is already connected to another account” (deze Hyperliquid-wallet is al aan een ander account gekoppeld). Eén wallet kan maar aan één Bybot-account worden gekoppeld.

Ik kan de sleutel niet verwijderen. Stop eerst je Hyperliquid-bots en verwijder daarna de sleutel.

De bot koopt niet, hoewel je USDC hebt gestort. In de standaardmodus komt de storting binnen op het Perps-saldo. Zet de USDC over naar Spot of schakel over naar Unified account.

De bot is traag geworden. De wallet heeft misschien zijn actielimiet bij Hyperliquid opgebruikt – zie ‘Actielimiet van Hyperliquid’ hierboven.

Officiële documentatie van de exchange: Hyperliquid Docs.