Wat je nodig hebt Een account op OKX Een account op Cryptotax (zie account aanmaken ) Stap 1: Maak een API-sleutel aan op OKX Log in op OKX en open het menu bij je profiel. Kies API en maak een nieuwe…
Wat je nodig hebt
- Een account op OKX
- Een account op Cryptotax (zie account aanmaken)
Stap 1: Maak een API-sleutel aan op OKX
- Log in op OKX en open het menu bij je profiel.
- Kies API en maak een nieuwe API-sleutel aan (Create V5 API key).
- Geef de sleutel een naam, bijvoorbeeld "Cryptotax".
- Kies zelf een passphrase. Die heb je straks nodig in Cryptotax.
- Vink bij de rechten enkel Read aan.
- Bevestig met je twee-stappenverificatie.
Welke rechten heb je nodig
Geef de sleutel enkel het recht Read. Vink Trade en Withdraw niet aan. Cryptotax leest alleen en kan niets kopen, verkopen of overschrijven.
De passphrase
OKX vraagt bij elke API-sleutel een passphrase. Die kies je zelf bij het aanmaken van de sleutel en OKX toont ze daarna niet meer. Bewaar ze samen met de API-sleutel en de geheime sleutel (Secret key). Ben je de passphrase kwijt? Dan kan je ze niet opvragen: maak een nieuwe API-sleutel aan.
Noteer ook meteen de API-sleutel en de geheime sleutel. OKX toont de geheime sleutel maar één keer.
IP-beperking is optioneel
OKX laat je de sleutel beperken tot bepaalde IP-adressen. Dat hoeft niet. Laat je de lijst leeg, dan werkt de koppeling meteen. Stel je toch een lijst in, dan moet het IP-adres van Cryptotax erop staan, anders weigert OKX de aanvraag. Zie een mislukte exchange-koppeling.
Stap 2: Voer de sleutel in op Cryptotax
- Log in op Cryptotax en ga naar Mijn bronnen.
- Klik op Bron toevoegen, kies Exchange en dan OKX.
- Plak je API-sleutel, je geheime sleutel en je passphrase in de juiste velden.
- Klik op OKX verbinden.
Je hoeft geen regio te kiezen. Cryptotax test je sleutel automatisch op OKX Europa (de entiteit voor Belgische gebruikers, my.okx.com) en daarna op de internationale OKX-site, en onthoudt waar hij werkt.
Stap 3: Synchroniseer je transacties
Na het opslaan van de sleutel start de synchronisatie automatisch. Afhankelijk van het aantal transacties duurt dit enkele seconden tot minuten.
Wat importeert Cryptotax van OKX
- Financieringsrekening (funding): stortingen, opnames, conversies, earn-opbrengsten en airdrops, vanaf 1 februari 2021.
- Trades (handelsrekening): de laatste 3 maanden. Verder terug geeft OKX ze niet vrij via de API.
Oudere trades: importeer een CSV
Heb je meer dan 3 maanden geleden op OKX gehandeld? Dan ontbreken die trades na de koppeling. Vul ze aan met een export:
- Log in op OKX en open je trade-geschiedenis (Trading history).
- Exporteer de periode die ontbreekt als CSV-bestand.
- Importeer het bestand in Cryptotax via CSV importeren, net zoals bij andere exchanges.
Exporteer enkel de periode van vóór de laatste 3 maanden: die komt al binnen via de API.
Belangrijke opmerkingen
- Koppel je OKX-account maar één keer.
- Cryptotax ondersteunt sleutels van OKX Europa en van de internationale OKX-site. Een sleutel van een andere OKX-entiteit (bijvoorbeeld OKX US) werkt niet.
- Trades via sub-accounts worden niet via de API ingelezen. Gebruik daarvoor een CSV-export.
Probleemoplossing
- Melding over ongeldige API-gegevens of een onjuiste passphrase: controleer de API-sleutel, de geheime sleutel en de passphrase. Let op extra spaties en op verwisselde velden. Weet je de passphrase niet meer, maak dan een nieuwe sleutel aan.
- Melding dat de sleutel ook handels- of opnamerechten heeft: Cryptotax weigert sleutels die meer kunnen dan lezen. Maak een nieuwe sleutel aan met enkel het recht Read.
- Melding over ontbrekende rechten: controleer of de sleutel het recht Read heeft.
- IP niet toegelaten: verwijder de IP-beperking op de sleutel of voeg het IP-adres van Cryptotax toe.
- Trades van langer dan 3 maanden geleden ontbreken: importeer de trade-geschiedenis als CSV, zie hierboven.