Фінансування через API

Останнє оновлення: 31 бер. 2025 р.

Вступ

Наш REST API надає кілька кінцевих точок фінансування, які дозволяють виконувати наступні завдання, пов'язані з депозитами/виведенням коштів:

  • •

    Отримати/створити адреси для депозитів

  • •

    Переглянути статус депозитних транзакцій

  • •

    Запит на виведення коштів (на вже затверджену адресу/рахунок)

  • •

    Переглянути статус транзакцій виведення коштів

Усі кінцеві точки фінансування REST API є приватними (автентифікованими) кінцевими точками, тому їх необхідно викликати за допомогою методу HTTP POST, і вони повинні містити дійсні значення автентифікації у заголовках HTTP.

Ключі API, що використовуються для запитів на фінансування, повинні включати певні дозволи, залежно від того, чи буде ключ лише для читання (дозволяє лише перегляд транзакцій фінансування) або повний доступ (дозволяє як перегляд, так і запит транзакцій фінансування).

Приклади

Нижче наведено приклади для кожної з кінцевих точок фінансування REST API (з використанням нашого клієнта командного рядка REST API):

DepositMethods

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

DepositAddresses (немає доступних адрес для депозитів)

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

DepositAddresses (створити нову адресу для депозиту)

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

DepositStatus (депозити у власній мережі)

% ./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)

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

Зверніть увагу на додаткове поле originators, яке надає оригінальний ідентифікатор транзакції (від клієнта до Kraken), на відміну від внутрішнього ідентифікатора транзакції (від Kraken до Kraken), наданого полем 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 (якщо можливо)

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

Невдалі приклади

Нижче наведено приклади деяких невдалих запитів на фінансування, що показують повідомлення про помилки, які можуть бути отримані:

DepositAddresses (без дійсного параметра method)

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

WithdrawInfo (використання неправильного опису в параметрі key)

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

Withdraw (використання адреси без необхідної інформації про бенефіціара/одержувача)

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

Зверніть увагу, що інформація про бенефіціара/одержувача наразі потрібна лише для окремих виведень коштів з канадських рахунків.

WithdrawCancel (для вже оброблюваного виведення коштів)

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

Потрібна додаткова допомога?