Documentación
Wallet

Transferencia entre Wallets

PostRequiere autenticación

Mueve fondos entre dos wallets pertenecientes al cliente autenticado, en la misma moneda. Cualquier comisión aplicable se deduce del monto antes de la ejecución, por lo que valide primero la transferencia para obtener una vista previa de la comisión y el monto neto. request_id es la clave de idempotencia: reenviar una que ya ha utilizado no crea una transferencia duplicada.

Endpoint

Post/wallet/v1/transfers

URL Base: https://api.derivws.com

Códigos de Estado

200OK - The transfer was executed, with the request_id echoed back.
400Bad request - The transfer breaks a transfer rule, or the body failed validation.
401Unauthorized - Missing or invalid Bearer token.
403Forbidden - Valid token but insufficient scope (payment scope required).
429Too many requests - Rate limit exceeded.
500Internal server error - errors[0].code will be InternalServerError.
503Service unavailable - Request rejected by the gateway circuit breaker.
504Gateway timeout - The service did not respond in time.

Respuestas de Error

400Validation error
{
  "errors": [
    {
      "status": 400,
      "code": "ValidationError",
      "message": "source_wallet_id must be a UUID",
      "field": "source_wallet_id"
    }
  ]
}
400Insufficient balance
{
  "errors": [
    {
      "status": 400,
      "code": "BadRequest",
      "message": "The source wallet does not hold enough funds for this transfer"
    }
  ]
}

Acerca de Transferencia entre Wallets

El endpoint POST /wallet/v1/transfers: Mueve fondos entre dos wallets pertenecientes al cliente autenticado, en la misma moneda. Cualquier comisión aplicable se deduce del monto antes de la ejecución, por lo que valide primero la transferencia para obtener una vista previa de la comisión y el monto neto. request_id es la clave de idempotencia: reenviar una que ya ha utilizado no crea una transferencia duplicada.

Click to open live chat support. Get instant help from our support team.