Financiering via de API

Laatst bijgewerkt: 31 mrt 2025

Introductie

Onze REST API biedt verschillende financierings-endpoints die de volgende stortings-/opnamegerelateerde taken mogelijk maken:

  • •

    Stortingsadressen ophalen/aanmaken

  • •

    De status van stortingstransacties bekijken

  • •

    Een opname aanvragen (naar een reeds goedgekeurd adres/account)

  • •

    De status van opnametransacties bekijken

De financierings-endpoints van de REST API zijn allemaal privé (geauthenticeerde) endpoints, daarom moeten ze worden aangeroepen met de HTTP POST-methode en moeten ze geldige authenticatiegegevens in de HTTP-headers bevatten.

API-sleutels die worden gebruikt voor financieringsaanvragen moeten bepaalde machtigingen bevatten, afhankelijk van of de sleutel alleen-lezen (alleen het bekijken van financieringstransacties toestaan) of volledige toegang (zowel het bekijken als het aanvragen van financieringstransacties toestaan) zal zijn.

Voorbeelden

Hieronder volgen voorbeelden voor elk van de REST API financierings-endpoints (met behulp van onze REST API commandoregelclient):

DepositMethods

% ./krakenapi DepositMethods asset=doge{"error":[],"result":[{"method":"Dogecoin","limit":false,"gen-address":true}]}

DepositAddresses (geen stortingsadressen beschikbaar)

% ./krakenapi DepositAddresses asset=doge method=Dogecoin{"error":[],"result":[]}

DepositAddresses (een nieuw stortingsadres aanmaken)

% ./krakenapi DepositAddresses asset=doge method=Dogecoin new=true{"error":[],"result":[{"address":"DFSHkVSQycPZDu8CkiNvx8ymHKHoMLteUD","expiretm":"0","new":true}]}

DepositStatus (native netwerkstortingen)

% ./krakenapi DepositStatus asset=doge{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSBALMX-YTM4MI-REMLWN","txid":"f0cf9b21eeabb87cd240b61ce813490bf03ae96427f5874a55768e7299a9ac9c","info":"DFSHkVSQycPZDu8CkiNvx8ymHKHoMLteUD","amount":"95.00000000","fee":"0.00000000","time":1676727227,"status":"Success"}]}

DepositStatus (ERC20 netwerkstortingen)

% ./krakenapi DepositStatus asset=usdc{"error":[],"result":[{"method":"USDC","aclass":"currency","asset":"USDC","refid":"Q4FTRAH-KPUTB7-ATW3UH","txid":"0x2756a446fa1bd75c4bb84b151a12456e52e0a65ff0aa5f35d7231cd25856058b","info":"0xc2ed795f33ed0b8b43fa8165de0107438237161e","amount":"10.00000000","fee":"0.00000000","time":1679452779,"status":"Success","originators":["0x9d7f5e4b07d8f3fb9456128191e4bc517d3d706da1b1dcf52037d0c93ecae3cc"]}

Let op het extra veld originators dat de originele transactie-ID (client naar Kraken) verschaft, in tegenstelling tot de interne transactie-ID (Kraken naar Kraken) die wordt verschaft door het veld txid.

WithdrawInfo

% ./krakenapi WithdrawInfo asset=doge key=XDG_Wallet amount=100{"error":[],"result":{"method":"XXDG","limit":"100.00000000","amount":"96.00000000","fee":"4.00000000"}}

Withdraw

% ./krakenapi Withdraw asset=doge key=XDG_Wallet amount=100 {"error":[],"result":{"refid":"ASBG2IX-OQZTG5-CRWGN3"}}

WithdrawStatus

% ./krakenapi WithdrawStatus asset=doge{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSBALMX-YTM4MI-REMLWN","txid":"86b9bbee8775793d0ef420e3c374a2e7913ad8ba9e1a4939cf3044a09c533e44","info":"DNtxrbNnPWf9RZQMYcrqLL6QRgHoozabwM","amount":"96.00000000","fee":"4.00000000","time":1676713821,"status":"Success"}]}

WithdrawCancel (indien mogelijk)

% ./krakenapi WithdrawCancel asset=doge refid=ASBTV5V-STE7C7-MIQUAC{"error":[],"result":true}

Mislukte voorbeelden

Hieronder volgen voorbeelden van enkele mislukte financieringsaanvragen, met de foutmeldingen die kunnen worden ontvangen:

DepositAddresses (zonder een geldige method parameter)

% ./krakenapi DepositAddresses asset=doge method=invalid {"error":["EFunding:No funding method"]}

WithdrawInfo (met een onjuiste beschrijving in de key parameter)

% ./krakenapi WithdrawInfo asset=doge key=invalid amount=100{"error":["EFunding:Unknown withdraw key"]}

Withdraw (met een adres zonder de vereiste begunstigde-/ontvangerinformatie)

% ./krakenapi Withdraw asset=btc key=BTC_Wallet amount=1.5{"error":["EGeneral:Invalid arguments:beneficiary_recipient"]}

Merk op dat begunstigde-/ontvangerinformatie momenteel alleen vereist is voor geselecteerde opnames van Canadese accounts.

WithdrawCancel (voor een reeds lopende opname)

% ./krakenapi WithdrawCancel asset=doge refid=ASBG2IX-OQZTG5-CRWGN3 {"error":["EFunding:Invalid reference id"]}

Meer hulp nodig?