Een crypto-exchange koppelen

Crypto-exchanges koppel je met een API-sleutel die je zelf aanmaakt. Eenmaal gekoppeld werken de saldi zich elke 15 minuten bij, zonder dat jij iets hoeft te doen.

Gylder ondersteunt op dit moment Bitvavo, Coinbase en Kraken.

Altijd alleen-lezen

Bij elke exchange kies je zelf wat een sleutel mag. Geef Gylder de smalst mogelijke rechten: saldi bekijken, verder niets.

Gylder handelt nooit en verplaatst nooit geld, dus een sleutel met handels- of opnamerechten geeft toegang die toch ongebruikt blijft. En lekt die sleutel ooit, dan is het verschil tussen een alleen-lezen sleutel en een handelssleutel het verschil tussen iemand die een saldo ziet en iemand die het uitgeeft.

De precieze namen van de rechten verschillen per exchange en staan hieronder. Het uitgangspunt verschilt niet: is een recht niet nodig om een saldo te lezen, zet het dan uit.

Bitvavo

1. Log in bij Bitvavo
2. Ga naar Account → API
3. Maak een nieuwe sleutel aan en zet alleen View aan
4. Zet Trade, Withdraw en alle overige rechten uit
5. Zet de API-sleutel en het secret in Gylder

Kijk daarna in je mail. Bitvavo stuurt een bevestigingslink, en de sleutel werkt pas als je daarop klikt. Dit is verreweg de vaakste reden dat een correcte Bitvavo-sleutel geweigerd wordt: Gylder meldt ongeldige gegevens, en de sleutel is ook echt ongeldig, omdat hij nooit geactiveerd is. Lukt het koppelen niet vlak nadat je een sleutel hebt aangemaakt, kijk dan eerst in je inbox voordat je gaat zoeken naar een typefout.

Coinbase

Coinbase gebruikt de Advanced Trade-API, die een ander soort sleutel uitgeeft dan de oude.

1. Log in bij Coinbase Advanced Trade
2. Ga naar Settings → API → New API Key
3. Kies alleen View, dus geen handelsrechten
4. Kopieer de API Key, die eruitziet als een UUID
5. Kopieer of download de Private Key, een blok PEM-tekst
6. Plak beide in Gylder

De private key beslaat meerdere regels en begint met -----BEGIN. Plak hem helemaal, inclusief die begin- en eindregels.

Kraken

1. Log in bij Kraken
2. Ga naar Settings → API
3. Klik op Add key
4. Zet bij de rechten alleen Query Funds en Query Ledger Entries aan
5. Laat alle overige rechten uit, dus geen handel en geen opnames
6. Zet de API-sleutel en de private key in Gylder

Query Ledger Entries is wat Gylder je geschiedenis laat lezen in plaats van alleen het saldo van vandaag. Zonder dat recht werkt de koppeling wel, maar is er minder om een verleden mee op te bouwen.

Hoe je sleutel bewaard wordt

Gegevens van exchanges worden versleuteld voordat ze in de database komen, met een sleutel die alleen bij jouw account hoort en die in AWS KMS ligt. Ze worden alleen in het geheugen van de server ontsleuteld, voor de duur van één synchronisatie, en gaan nooit naar je browser.

Verwijder je je account, dan wordt die accountsleutel vernietigd. Daarmee zijn de opgeslagen gegevens blijvend onleesbaar.

Na het koppelen

De saldi worden ongeveer elk kwartier ververst. Crypto beweegt snel en de API's van exchanges zijn goedkoop te bevragen, en daarom gaat dit veel vaker dan het dagelijkse schema van tragere rekeningen.

Je posities gedragen zich daarna als elke andere bezitting in Gylder: ze tellen mee in je nettovermogen, staan in de spreiding, en verschijnen op het beleggingsdashboard naast je effecten. In gewicht van een positie staat hoe het aandeel van een positie berekend wordt.

Als een koppeling stopt met werken

Een koppeling kan stuklopen om redenen die niets met Gylder te maken hebben.

De sleutel is ingetrokken of verlopen. Exchanges laten sleutels verlopen, sommige al na een periode zonder gebruik. Maak een nieuwe aan en koppel opnieuw.

De sleutel is nooit geactiveerd. Weer Bitvavo. Zie hierboven.

De rechten zijn te smal. Een sleutel die wel saldi maar geen geschiedenis mag lezen koppelt prima en laat daarna minder zien dan je verwacht.

Je hebt je wachtwoord bij de exchange gewijzigd. Sommige exchanges maken API-sleutels daarbij ongeldig.

In alle gevallen is de oplossing dezelfde: maak een nieuwe alleen-lezen sleutel aan en koppel opnieuw. Je geschiedenis in Gylder gaat niet verloren wanneer een sleutel stopt met werken, want die is al opgeslagen.

Over abonnementen

Een gekoppelde exchange telt als integratie, en hoeveel je er mag hebben hangt af van je abonnement. Loopt je proefperiode af zonder abonnement, dan blijven bestaande koppelingen staan maar stopt het bijwerken, dus de gegevens bevriezen in plaats van te verdwijnen.