Documentação
Wallet

Transferência entre Wallets

PostAutenticação necessária

Move fundos entre duas wallets pertencentes ao cliente autenticado, na mesma moeda. Qualquer taxa aplicável é deduzida do montante antes da execução, pelo que deve validar a transferência primeiro para pré-visualizar a taxa e o montante líquido. request_id é a chave de idempotência: reenviar uma que já tenha utilizado não cria uma transferência 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.

Respostas de Erro

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 Transferência entre Wallets

O endpoint POST /wallet/v1/transfers: Move fundos entre duas wallets pertencentes ao cliente autenticado, na mesma moeda. Qualquer taxa aplicável é deduzida do montante antes da execução, pelo que deve validar a transferência primeiro para pré-visualizar a taxa e o montante líquido. request_id é a chave de idempotência: reenviar uma que já tenha utilizado não cria uma transferência duplicada.

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