Financiación a través de la API

Última actualización: 31 mar 2025

Introducción

Nuestra API REST proporciona varios puntos finales de financiación que permiten realizar las siguientes tareas relacionadas con depósitos/retiros:

  • •

    Recuperar/crear direcciones de depósito

  • •

    Ver el estado de las transacciones de depósito

  • •

    Solicitar un retiro (a una dirección/cuenta ya aprobada)

  • •

    Ver el estado de las transacciones de retiro

Todos los puntos finales de financiación de la API REST son privados (autenticados), por lo que deben ser llamados utilizando el método HTTP POST, y deben incluir valores de autenticación válidos en los encabezados HTTP.

Las claves API utilizadas para las solicitudes de financiación deben incluir ciertos permisos, dependiendo de si la clave será de solo lectura (solo permite ver transacciones de financiación) o de acceso completo (permite ver y solicitar transacciones de financiación).

Ejemplos

Los siguientes son ejemplos para cada uno de los puntos finales de financiación de la API REST (utilizando nuestro cliente de línea de comandos de la API REST):

DepositMethods

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

DepositAddresses (no hay direcciones de depósito disponibles)

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

DepositAddresses (crear una nueva dirección de depósito)

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

DepositStatus (depósitos de red nativa)

% ./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 (depósitos de red 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"]}]}

Tenga en cuenta el campo adicional originators que proporciona el ID de transacción original (cliente a Kraken), a diferencia del ID de transacción interno (Kraken a Kraken) proporcionado por el campo 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 es posible)

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

Ejemplos fallidos

Los siguientes son ejemplos de algunas solicitudes de financiación fallidas, mostrando los mensajes de error que se podrían recibir:

DepositAddresses (sin un parámetro method válido)

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

WithdrawInfo (utilizando una descripción incorrecta en el parámetro key)

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

Withdraw (utilizando una dirección sin la información de beneficiario/destinatario requerida)

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

Tenga en cuenta que la información del beneficiario/destinatario solo se requiere actualmente para retiros seleccionados de cuentas canadienses.

WithdrawCancel (para un retiro ya en proceso)

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

¿Necesita más ayuda?