Voordat een bot voor je kan handelen, heeft Freya een verbinding nodig met de exchange waar je geld staat — Binance, OKX of Bybit. Je verplaatst je geld niet en deelt je wachtwoord niet om dit te doen. In plaats daarvan maak je een API-sleutel aan: een beperkt inloggegeven waarmee Freya namens jou trades kan plaatsen, terwijl je geld op je eigen exchange-account blijft staan.
Deze gids legt precies uit welke rechten je moet geven (en welke je nooit moet geven), hoe je de sleutel aan Freya toevoegt en wat je moet doen als de verbinding niet valideert. Als je het grotere plaatje wilt zien van waarom dit veilig is, lees dan eerst Is Mijn Geld Veilig op Freya Finance?.
Belangrijkste punten
- Je verbindt een exchange met een API-sleutel — een beperkt inloggegeven — niet door geld te verplaatsen of je exchange-wachtwoord te delen.
- De sleutel heeft lees- en Spot- en/of Futures-handelsrechten nodig. Hij mag NOOIT opnamerechten hebben.
- OKX-sleutels vereisen een passphrase die je instelt wanneer je ze aanmaakt; Binance en Bybit niet.
- Voeg de sleutel toe in Freya onder Instellingen → API-sleutels → API-sleutel toevoegen, en Freya valideert hem direct.
- Als de validatie mislukt, vertelt Freya je precies waarom — ongeldige sleutel, IP niet op de whitelist, of een ontbrekend recht — en elk heeft een eenvoudige oplossing.
Een Snel Overzicht van de Stappen
- Maak een API-sleutel aan op je exchange met lees- en handelsrechten, maar niet met opnamerechten.
- Kopieer de inloggegevens — de API-sleutel, de secret en (voor OKX) de passphrase.
- Voeg de sleutel toe aan Freya onder Instellingen → API-sleutels → API-sleutel toevoegen, en selecteer je exchange.
- Laat Freya hem valideren — Freya controleert de verbinding en de rechten direct.
- Los elke fout op die het meldt — Freya vertelt je precies wat er mis is als de validatie mislukt.
Wat een API-sleutel Is — en Welke Rechten Freya Nodig Heeft
Een API-sleutel is een paar inloggegevens (een sleutel en een secret) waarmee één app op een beperkte manier met je exchange-account kan praten. Jij bepaalt wat die sleutel mag doen. Schakel voor Freya alleen in:
- Lezen — zodat Freya je saldi, posities en orderstatus kan zien.
- Spot-handel en/of Futures-handel — zodat je bot de orders kan plaatsen die het nodig heeft. Schakel in wat past bij de bots die je van plan bent te draaien.
Freya plaatst trades; het hoeft nooit geld van je account te verplaatsen. Laat opnamerechten altijd uitgeschakeld op de sleutel die je verbindt. Dit is een recht dat je op de exchange beheert — met dit recht uit kan noch Freya, noch iemand die de sleutel eventueel bemachtigt, je geld opnemen. Het is de belangrijkste gewoonte bij het verbinden van welk botplatform dan ook.
Stap 1: Maak een API-sleutel aan op Je Exchange
Maak in het API-beheer van je exchange een nieuwe API-sleutel aan:
- Binance — maak de sleutel aan onder API Management, schakel lezen en Spot- en/of Futures-handel in, en laat opnames uit.
- OKX — maak de sleutel aan en stel een passphrase in (die heb je nodig in Freya); schakel lezen en handel in, geen opnames.
- Bybit — maak de sleutel aan met lees- en handelsrechten voor de producten die je gaat gebruiken, en laat opnames uit.
Als je exchange IP-whitelisting biedt, is het goede praktijk om de sleutel te beperken tot Freya's IP-adressen. Als je dat doet, zorg er dan voor dat je Freya's IP's op de whitelist zet, anders wordt de verbinding geweigerd (zie de fouttabel hieronder).
Wanneer je de sleutel aanmaakt, toont de exchange de secret één enkele keer. Kopieer hem direct en bewaar hem veilig. Als je hem kwijtraakt, kun je hem niet meer herstellen — je moet dan de sleutel verwijderen en een nieuwe aanmaken.
Stap 2: Voeg de Sleutel toe aan Freya
Ga in Freya naar Instellingen → API-sleutels en selecteer API-sleutel toevoegen. Dan:
- Kies je exchange (Binance, OKX of Bybit).
- Plak de API-sleutel en de secret. Voer voor OKX ook de passphrase in die je hebt ingesteld.
- Geef de sleutel een naam zodat je hem later kunt herkennen.
Je kunt meer dan één exchange verbinden, en je sleutels op deze zelfde pagina op elk moment beheren of verwijderen.
Stap 3: Freya Valideert Je Sleutel
Zodra je de sleutel toevoegt, controleert Freya de verbinding en de rechten — er is geen giswerk. Als alles klopt, is de sleutel geverifieerd en klaar voor gebruik. Als er iets mis is, toont Freya een duidelijke melding die precies uitlegt wat je moet oplossen.
Validatiefouten Begrijpen
Als de validatie mislukt, koppel dan de melding die Freya toont aan de oplossing hieronder:
| Wat Freya toont | Wat het betekent | Hoe je het oplost |
|---|---|---|
| Invalid API Key | De sleutel is verkeerd gekopieerd of verwijderd op de exchange | Kopieer de API-sleutel exact opnieuw, of maak een nieuwe aan |
| Invalid Secret Key | De secret komt niet overeen met de sleutel | Kopieer de secret opnieuw; als je hem kwijt bent, maak een nieuwe sleutel aan |
| IP Address Not Whitelisted | De sleutel is IP-beperkt en Freya's adres is niet toegestaan | Zet Freya's IP's op de whitelist van de sleutel, of verwijder de IP-beperking |
| Missing Permissions | De sleutel mist lees- of handelsrechten | Schakel lezen en Spot-/Futures-handel in op de sleutel |
| Reading Permission Disabled | Freya kan je account niet lezen | Schakel het lees-/bekijkrecht in op de sleutel |
| Spot/Futures Permission Disabled | De sleutel kan de orders die je bot nodig heeft niet plaatsen | Schakel het handelstype (Spot of Futures) in dat past bij je bot |
| Connection Failed | Een tijdelijk netwerk- of exchangeprobleem | Wacht even en probeer de sleutel opnieuw toe te voegen |
Freya markeert ook een sleutel die in “Unrestricted”-modus staat — wat betekent dat hij geen IP-beperking heeft. Voor je veiligheid vraagt Freya je om de IP-beperking aan te zetten en het adres toe te voegen dat het toont voordat de sleutel kan worden opgeslagen. Schakel alleen lezen en handel in (nooit opnames), en beperk de sleutel tot Freya's IP. (Meer over verbindingsfouten in Kun Je Je Exchange Niet Verbinden?.)
Een Opmerking over Beveiliging
De verbinding is veilig door ontwerp, maar een paar gewoonten houden dat zo:
- Opnames uit, altijd — Freya heeft ze nooit nodig.
- Gebruik IP-whitelisting wanneer je exchange dit ondersteunt.
- Eén sleutel, één doel — en verwijder sleutels die je niet meer gebruikt.
Voor het volledige plaatje van hoe je geld en sleutels beschermd worden, zie Is Mijn Geld Veilig op Freya Finance? en Exchange API-beveiliging & Risicobeperking.
Veelgestelde Vragen
Welke rechten heeft Freya nodig op mijn API-sleutel?
Lezen (om je saldi, posities en orders te zien) en Spot- en/of Futures-handel (om de orders van je bot te plaatsen). Schakel het handelstype in dat past bij de bots die je gaat draaien. Freya heeft nooit opnamerechten nodig, dus laat die altijd uitgeschakeld.
Heeft Freya toestemming nodig om mijn geld op te nemen?
Nee. Freya plaatst en beheert alleen trades; het kan en zou geen geld van je exchange moeten kunnen verplaatsen. Laat opnamerechten altijd uit op de sleutel die je verbindt — het is een recht dat je op de exchange beheert.
Waarom zegt Freya “IP Address Not Whitelisted”?
Je API-sleutel is beperkt tot specifieke IP-adressen, en Freya's adres staat niet op de lijst. Voeg ofwel Freya's IP-adressen toe aan de whitelist van de sleutel op je exchange, of verwijder de IP-beperking van de sleutel. Voeg na het bijwerken de sleutel opnieuw toe in Freya.
Waarom zegt het “Invalid API Key” of “Invalid Secret Key”?
Meestal is de sleutel of de secret verkeerd gekopieerd, of is de sleutel verwijderd of opnieuw gegenereerd op de exchange. Kopieer beide waarden exact opnieuw. Omdat de secret maar één keer wordt getoond wanneer je de sleutel aanmaakt, moet je — als je hem niet meer hebt — de sleutel op de exchange verwijderen en een nieuwe aanmaken.
Wat is de passphrase, en waarom vraagt OKX ernaar?
OKX API-sleutels bevatten een passphrase die je zelf instelt wanneer je de sleutel aanmaakt — het is een extra inloggegeven naast de sleutel en de secret. Voer dezelfde passphrase in Freya in wanneer je een OKX-sleutel toevoegt. Binance en Bybit gebruiken geen passphrase.
Kan ik meer dan één exchange verbinden?
Ja. Je kunt API-sleutels toevoegen voor Binance, OKX en Bybit, en ze op elk moment beheren of verwijderen via Instellingen → API-sleutels.
Is het veilig om Freya mijn API-sleutel te geven?
Ja, wanneer de sleutel correct is ingesteld — alleen lezen en handelen, geen opnames, en met IP-whitelist waar mogelijk. Je geld blijft op je eigen exchange, en de sleutel die je deelt kan het niet verplaatsen. Voor de volledige uitleg, zie Is Mijn Geld Veilig op Freya Finance?
Welke exchanges ondersteunt Freya?
Freya verbindt momenteel met Binance, OKX en Bybit (spot en futures). Er kunnen na verloop van tijd meer exchanges worden toegevoegd. Je handelt op welke van deze je ook verbindt — je geld en de beschikbare markten blijven op die exchange.
Welke coins of trading-paren kan ik verhandelen?
De beschikbare paren komen uit de eigen listings van je verbonden exchange, niet uit een aparte Freya-lijst — dus als je exchange een paar noteert (bijv. BTC/USDT, ETH/USDT), kun je er een bot op bouwen. De meeste handel gaat tegen USDT als quote-valuta. Als een exchange een paar delist, is het daar niet meer verhandelbaar.