Wanneer je een exchange API-sleutel toevoegt, controleert Freya deze voordat hij wordt opgeslagen — en als er iets mis is, vertelt het je wat je moet oplossen. Deze gids helpt je dat resultaat te lezen en te verhelpen. (Als je sleutel prima verbond maar een bot later stopte, is dat een ander probleem — zie Waarom Is Mijn Bot Gepauzeerd of Gestopt?.)
Voor de eerste installatiestappen begin je met Hoe Verbind Je Je Exchange; dit artikel gaat over wat je doet wanneer die verbinding mislukt.
Belangrijkste punten
- Wanneer je een sleutel toevoegt, controleert Freya of deze verbindt en de juiste permissies heeft voordat hij wordt opgeslagen — als er iets misgaat, vertelt de foutmelding je wat je moet oplossen.
- “Ongeldige API-sleutel/Secret” betekent meestal een kopieer-/plakfoutje of een sleutel die opnieuw is gegenereerd; “IP”-fouten betekenen dat de IP-beperking van de sleutel niet overeenkomt met wat Freya nodig heeft.
- Je sleutel moet lees- en handelspermissies hebben (nooit opname) en ingeschakeld zijn voor de juiste markt — spot of futures — zodat het bij je bot past.
- OKX-sleutels vereisen een passphrase die exact moet overeenkomen; voor futures-sleutels bereidt Freya je account automatisch voor zodat de bot correct kan handelen.
- Een algemene “Verbinding Mislukt” is vaak een tijdelijke netwerk- of exchange-hapering — probeer het gewoon opnieuw.
Wanneer een Sleutel Niet Verbindt
Een sleutel toevoegen is geen blinde opslag — Freya verifieert dat de sleutel werkt en de juiste permissies heeft voordat hij versleuteld wordt opgeslagen. Als er iets mis is, wijst de foutmelding je direct naar de oorzaak — meestal de sleutel of secret, de IP-beperking, of een ontbrekende permissie. De secties hieronder lopen elke fout door en hoe je deze oplost.
"Ongeldige API-sleutel" of "Ongeldige Secret Key"
De meest voorkomende verbindingsfout, en meestal de eenvoudigste:
- Een kopieer-/plakfoutje — een verdwaalde spatie of een ontbrekend teken. Kopieer zowel de sleutel als de secret zorgvuldig opnieuw.
- De secret wordt slechts één keer getoond. Exchanges onthullen de secret key één enkele keer wanneer je hem aanmaakt. Als je hem niet hebt opgeslagen, kun je hem niet meer terughalen — maak een nieuwe sleutel aan.
- De sleutel is verwijderd of opnieuw gegenereerd op de exchange, waardoor hij niet meer overeenkomt.
Oplossing: voer de sleutel en secret exact opnieuw in, of maak een verse sleutel aan en probeer het opnieuw.
IP-beperkingsfouten
Freya verbindt vanaf zijn eigen servers, dus de IP-instellingen van de sleutel zijn van belang. Er zijn twee verschillende gevallen:
- "IP Niet Whitelisted" — je sleutel is IP-beperkt, maar het serveradres van Freya staat niet op de toegestane lijst. Het scherm API-sleutel Toevoegen toont je de IP-adres(sen) om toe te voegen (met een kopieerknop) — voeg deze toe aan de whitelist van de sleutel op de exchange.
- "Onbeperkt" — je sleutel heeft helemaal geen IP-beperking. Voor je veiligheid vraagt Freya je om IP-beperking in te schakelen en het adres toe te voegen dat het toont, en het daarna opnieuw te proberen.
In beide gevallen is de oplossing hetzelfde idee: beperk de sleutel tot het IP dat Freya in de modal weergeeft.
Permissiefouten
De sleutel verbond, maar hij kan niet doen wat je bot nodig heeft:
- Lezen uitgeschakeld — schakel lees-/bekijkpermissie in op de sleutel.
- Handelspermissie ontbreekt — schakel handelen in (spot en/of futures, passend bij je bot).
- Spot vs Futures mismatch — een futures-bot heeft een sleutel nodig met futures-handel ingeschakeld; een spot-bot heeft spot-handel nodig. Als je een spot-only sleutel hebt toegevoegd voor een futures-bot (of omgekeerd), markeert Freya dit. Zorg ervoor dat de ingeschakelde markt van de sleutel overeenkomt met de bot die je bouwt.
Onthoud: Freya heeft alleen ooit lees- en handelspermissies nodig — nooit opname. Een sleutel zonder opnamepermissie is precies wat je wilt.
Exchange-specifieke Valkuilen
- OKX heeft een passphrase nodig. Wanneer je een OKX-sleutel aanmaakt, stel je een passphrase in — voer diezelfde passphrase in Freya in, exact zoals je hem hebt ingesteld. Een verkeerde passphrase is een veelvoorkomende oorzaak van een mislukte OKX-verbinding.
- OKX futures-setup. OKX futures-handel vereist een specifieke accountmodus, die Freya automatisch voor je instelt — je hoeft het niet handmatig te configureren.
- Hedge mode (futures). Freya gebruikt hedge mode voor futures-accounts. Als je al open one-way posities hebt die hiermee conflicteren, zie je mogelijk een waarschuwing in plaats van een fout — de sleutel wordt nog steeds opgeslagen, en je bot kan handelen zodra die bestaande posities gesloten zijn.
- Binance en Bybit gebruiken geen passphrase — voor hen is er geen passphrase-veld.
"Verbinding Mislukt" Zonder Duidelijke Reden
Een algemene verbindingsfout ligt vaak niet aan jou — een tijdelijke netwerkhapering of een exchange die even druk is. Wacht even en probeer het opnieuw. Als het na een paar pogingen blijft mislukken, controleer dan nogmaals de sleutel/secret en IP-instellingen hierboven.
Nog Steeds Vast? Een Snelle Checklist
- Maak de sleutel opnieuw aan op de exchange met alleen lezen + handelen (nooit opname).
- Beperk hem tot het IP dat Freya toont in het scherm API-sleutel Toevoegen.
- Match de markt — een spot-sleutel voor een spot-bot, een futures-sleutel voor een futures-bot.
- OKX: voer de exacte passphrase in.
- Blijft het mislukken? Neem contact op met [email protected].
Veelgestelde Vragen
Freya zegt "Ongeldige API-sleutel" maar ik weet zeker dat ik hem correct heb gekopieerd — wat is er mis?
Meestal is er een verborgen teken of spatie in de sleutel of secret geslopen, of is de sleutel opnieuw gegenereerd/verwijderd op de exchange waardoor hij niet meer overeenkomt. Kopieer beide velden zorgvuldig opnieuw, en onthoud dat de secret slechts één keer bij het aanmaken wordt getoond — als je hem niet hebt, maak dan een verse sleutel aan.
Wat is het verschil tussen "IP Niet Whitelisted" en "Onbeperkt"?
"IP Niet Whitelisted" betekent dat je sleutel IP-beperkt is maar het serveradres van Freya nog niet is toegestaan — voeg het adres dat Freya toont toe aan de whitelist van de sleutel. "Onbeperkt" betekent dat de sleutel helemaal geen IP-beperking heeft; voor de veiligheid vraagt Freya je om IP-beperking in te schakelen en zijn adres toe te voegen voordat je opslaat.
Mijn OKX-sleutel verbindt niet — heb ik de passphrase nodig?
Ja. OKX-sleutels hebben een passphrase die je instelt wanneer je de sleutel aanmaakt. Je moet die exacte passphrase in Freya invoeren — een verkeerde of ontbrekende passphrase is een veelvoorkomende oorzaak van een mislukte OKX-verbinding. Binance en Bybit gebruiken er geen.
Freya zegt dat mijn sleutel geen trades kan plaatsen — hoe los ik dit op?
Je sleutel heeft geen handel ingeschakeld voor de markt die je bot gebruikt. Schakel op de exchange handelspermissie in — spot-handel voor een spot-bot, futures-handel voor een futures-bot — en verbind daarna opnieuw. Freya heeft lees- en handelspermissies nodig, nooit opname.
Mijn futures-sleutel heeft extra setup nodig (accountmodus / hedge mode) — is dat een probleem?
Nee. Futures-handel vereist een specifieke accountmodus en hedge mode, die Freya automatisch voor je instelt. Als je bestaande one-way posities hebt, zie je mogelijk een hedge-mode-waarschuwing in plaats van een fout — de sleutel wordt nog steeds opgeslagen, en je bot kan handelen zodra die posities gesloten zijn.
Ik heb een spot-sleutel toegevoegd maar mijn futures-bot gebruikt hem niet (of omgekeerd) — waarom?
Een sleutel is ingeschakeld voor een specifieke markt. Een futures-bot heeft een sleutel nodig met futures-handel ingeschakeld, en een spot-bot heeft spot-handel nodig. Als ze niet overeenkomen, markeert Freya dit. Verbind een sleutel waarvan de ingeschakelde markt overeenkomt met de bot die je aan het maken bent.
De verbinding "mislukte" gewoon zonder duidelijke reden — ligt het aan mij of aan de exchange?
Vaak is het een tijdelijke netwerk- of exchange-hapering in plaats van je instellingen. Probeer het over een moment opnieuw. Als het blijft mislukken, controleer de sleutel en secret nogmaals op kopieerfouten en bevestig dat de IP-beperking overeenkomt met het adres dat Freya toont.