Finanțare prin API

Ultima actualizare: 31 martie 2025

Introducere

API-ul nostru REST oferă mai multe puncte finale de finanțare care permit îndeplinirea următoarelor sarcini legate de depuneri/retrageri:

  • •

    Recuperați/creați adrese de depunere

  • •

    Vizualizați starea tranzacțiilor de depunere

  • •

    Solicitați o retragere (către o adresă/un cont deja aprobat)

  • •

    Vizualizați starea tranzacțiilor de retragere

Punctele finale de finanțare ale API-ului REST sunt toate puncte finale private (autentificate), prin urmare, acestea trebuie apelate folosind metoda HTTP POST și trebuie să includă valori de autentificare valide în antetele HTTP.

Cheile API utilizate pentru cererile de finanțare trebuie să includă anumite permisiuni, în funcție de faptul dacă cheia va fi doar pentru citire (permite doar vizualizarea tranzacțiilor de finanțare) sau cu acces complet (permite atât vizualizarea, cât și solicitarea tranzacțiilor de finanțare).

Exemple

Următoarele sunt exemple pentru fiecare dintre punctele finale de finanțare ale API-ului REST (folosind clientul nostru de linie de comandă pentru API-ul REST):

DepositMethods

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

DepositAddresses (nu sunt disponibile adrese de depunere)

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

DepositAddresses (creați o nouă adresă de depunere)

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

DepositStatus (depuneri în rețeaua nativă)

% ./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 (depuneri în rețeaua 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"]}

Rețineți câmpul suplimentar originators care oferă ID-ul tranzacției originale (client către Kraken), spre deosebire de ID-ul tranzacției interne (Kraken către Kraken) furnizat de câmpul 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 (dacă este posibil)

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

Exemple eșuate

Următoarele sunt exemple de cereri de finanțare eșuate, arătând mesajele de eroare care ar putea fi primite:

DepositAddresses (fără un parametru method valid)

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

WithdrawInfo (folosind o descriere incorectă în parametrul key)

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

Withdraw (folosind o adresă fără informațiile necesare despre beneficiar/destinatar)

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

Rețineți că informațiile despre beneficiar/destinatar sunt necesare în prezent doar pentru anumite retrageri din conturile canadiene.

WithdrawCancel (pentru o retragere deja în curs de procesare)

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

Ai nevoie de mai mult ajutor?