De Bitvavo-API uitgelegd voor niet-programmeurs

Toen ik besloot een tradingbot te bouwen zonder enige developer-achtergrond, stuitte ik meteen op een jungle aan begrippen. API's, REST-endpoints, webhook-payloads. Voor iemand die 23 jaar in de bankenwereld werkte met Bloomberg-terminals en Excel, voelde dat als een vreemde taal. Toch bleek het minder ingewikkeld dan ik dacht, zolang je begrijpt wat een exchange-API doét en waarom sommige platforms beter passen bij jouw situatie dan andere.

Wat is een exchange-API eigenlijk?

Een API – Application Programming Interface – is simpelweg een tussenpersoon die jouw software toestaat om met een crypto-exchange te praten. In plaats van handmatig in te loggen, op knoppen te klikken en orders te plaatsen, stuurt jouw bot opdrachten via die API: "Koop 0,01 BTC tegen marktprijs", "Haal mijn huidige saldo op", "Annuleer die lopende order". De exchange begrijpt die opdrachten, voert ze uit en stuurt een bevestiging terug. Zo kan een bot 24 uur per dag, zeven dagen per week handelen zonder dat jij wakker hoeft te blijven.

Alle grote exchanges – Binance, Kraken, Coinbase, Bitvavo – bieden zo'n API aan. Het verschil zit in de documentatie, de snelheid, de kosten en vooral in de veiligheid van hoe je die toegang configureert. Dat laatste punt was voor mij doorslaggevend.

Waarom ik Bitvavo koos boven alternatieven

Mijn situatie: ik woon in Vietnam, maar ben Nederlander. Ik wilde handelen in euro, niet in USD of USDT, omdat dat scheelt in conversiekosten en administratie. Bitvavo is een Nederlandse exchange, gereguleerd door De Nederlandsche Bank, en werkt direct met SEPA-overschrijvingen. Dat gaf me meer vertrouwen dan een platform zonder Europese vergunning.

Daarnaast is de API-documentatie van Bitvavo gewoon begrijpelijk. Geen cryptische jargon, geen onduidelijke rate-limits die je account plotseling blokkeren. Ik kon binnen een uur testen met demo-keys, zien hoe orders werken en begrijpen welke foutmeldingen ik terug kreeg. Voor iemand zonder programmeerachtergrond is dat goud waard.

Het verschil tussen read-only en trade-only API-sleutels

Hier wordt het belangrijk. Wanneer je een API-sleutel aanmaakt, kun je rechten toekennen: read-only (alleen balans en ordergeschiedenis opvragen), trade (orders plaatsen en annuleren) en withdraw (geld opnemen naar een extern adres). Die laatste optie – withdraw – heb ik nooit aangezet. Waarom? Omdat als een aanvaller toegang krijgt tot mijn bot of mijn VPS, hij dan wel orders kan plaatsen maar nooit mijn euro's of bitcoin naar zijn eigen wallet kan sturen.

Mijn bot draait op Replit (de AI-agent schreef de code) en het dashboard op een Hostinger VPS. Beide omgevingen zijn redelijk veilig, maar ik ga niet het risico nemen dat één fout in de code of één gelekte environment-variabele leidt tot een leeggeplunderde exchange-account. Trade-only keys zijn de standaard die ik iedereen aanraad.

Hoe mijn bot er in de praktijk op draait

Elke minuut haalt de bot via de API de huidige BTC/EUR-prijs op, vergelijkt die met mijn moving averages, en beslist of er een order geplaatst moet worden. Als dat zo is, stuurt hij een POST-request naar het /order-endpoint van Bitvavo met parameters als market, side (buy/sell), orderType (market/limit) en amount. De exchange antwoordt met een orderId, die ik bewaar in mijn database. Later controleer ik of de order is uitgevoerd en update ik mijn positie.

Geen magie, geen black box. Gewoon een kwestie van data ophalen, logica toepassen en opdrachten geven. De AI-agent van Replit schreef de Python-code, ik vertelde wat ik wilde. De Bitvavo-API maakte het mogelijk om dat plan om te zetten in echte trades, zonder dat ik zelf de browser hoef te openen. Dat geeft me tijd terug voor mijn gezin hier in Saigon – en dat was het doel vanaf dag één.

Disclaimer: dit artikel deelt mijn persoonlijke ervaring en is geen financieel advies. Crypto en gehandelde producten zijn risicovol — koersen kunnen hard dalen en een systeem dat in het verleden werkte, biedt geen garantie voor de toekomst. Handel alleen met geld dat je kunt missen.