Financement via l'API

Dernière mise à jour : 31 mars 2025

Introduction

Notre API REST fournit plusieurs points de terminaison de financement qui permettent d'effectuer les tâches suivantes liées aux dépôts/retraits :

  • •

    Récupérer/créer des adresses de dépôt

  • •

    Afficher le statut des transactions de dépôt

  • •

    Demander un retrait (vers une adresse/un compte déjà approuvé)

  • •

    Afficher le statut des transactions de retrait

Les points de terminaison de financement de l'API REST sont tous des points de terminaison privés (authentifiés), ils doivent donc être appelés en utilisant la méthode HTTP POST et doivent inclure des valeurs d'authentification valides dans les en-têtes HTTP.

Les clés API utilisées pour les demandes de financement doivent inclure certaines autorisations, selon que la clé sera en lecture seule (permettant uniquement de visualiser les transactions de financement) ou en accès complet (permettant à la fois de visualiser et de demander des transactions de financement).

Exemples

Voici des exemples pour chacun des points de terminaison de financement de l'API REST (en utilisant notre client en ligne de commande de l'API REST) :

DepositMethods

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

DepositAddresses (aucune adresse de dépôt disponible)

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

DepositAddresses (créer une nouvelle adresse de dépôt)

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

DepositStatus (dépôts sur réseau natif)

% ./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 (dépôts sur réseau ERC20)

% ./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"]}]}

Notez le champ originators supplémentaire qui fournit l'ID de transaction original (client vers Kraken), par opposition à l'ID de transaction interne (Kraken vers Kraken) fourni par le champ 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":"ASBG2IX-OQZTG5-CRWGN3","txid":"86b9bbee8775793d0ef420e3c374a2e7913ad8ba9e1a4939cf3044a09c533e44","info":"DNtxrbNnPWf9RZQMYcrqLL6QRgHoozabwM","amount":"96.00000000","fee":"4.00000000","time":1676713821,"status":"Success"}]}

WithdrawCancel (si possible)

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

Exemples d'échecs

Voici des exemples de demandes de financement échouées, montrant les messages d'erreur qui pourraient être reçus :

DepositAddresses (sans paramètre method valide)

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

WithdrawInfo (en utilisant une description incorrecte dans le paramètre key)

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

Withdraw (en utilisant une adresse sans les informations de bénéficiaire/destinataire requises)

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

Notez que les informations de bénéficiaire/destinataire ne sont actuellement requises que pour certains retraits depuis des comptes canadiens.

WithdrawCancel (pour un retrait déjà en cours)

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

Besoin d’aide supplémentaire ?