Saques

​

Criar Saque

​

Corpo da requisição

​

Cabeçalhos

​

Repetição segura

• A mesma chave com os mesmos to_address, amount_trx e currency retorna 200 com o saque criado pela primeira requisição, no estado atual. Nada é cobrado duas vezes.
• A mesma chave com outro corpo é recusada com 422 e o código IDEMPOTENCY_KEY_REUSED; uma chave com mais de 64 caracteres — com 422 e IDEMPOTENCY_KEY_TOO_LONG. As chaves valem dentro da sua conta e não expiram — nunca reutilize uma chave em outro saque.
• Um saque não finalizado (pending, scheduled ou processing) por vez: outra requisição enquanto ele existir recebe 400 com You already have a pending withdrawal.
• Depois de um saque criado com Idempotency-Key, o próximo pode ser criado em 5 segundos; sem o cabeçalho a pausa continua de 60 segundos (429, veja Limites de requisições).

​

Exemplo

curl -X POST https://api.tronrental.com/v1/account/withdrawal \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7f9c2b1e-5d4a-4c1e-9b3f-2a6d8e0c4f11" \
  -d '{
    "to_address": "TDestinationAddress...",
    "amount_trx": "100"
  }'

{
  "id": 56,
  "to_address": "TDestinationAddress...",
  "amount_trx": "100.00",
  "fee_trx": "1.00",
  "status": "completed",
  "tx_hash": "a1b2c3d4e5f6...",
  "created_at": "2026-03-05T12:00:00Z"
}

​

Listar Saques

curl https://api.tronrental.com/v1/account/withdrawals \
  -H "X-API-Key: your_api_key"

[
  {
    "id": 56,
    "to_address": "TDestinationAddress...",
    "amount_trx": "100.00",
    "fee_trx": "1.00",
    "status": "completed",
    "tx_hash": "a1b2c3d4e5f6...",
    "created_at": "2026-03-05T12:00:00Z"
  }
]

​

Status dos saques

​

Bloqueio de segurança após a alteração do e-mail

{
  "detail": {
    "error": {
      "code": "WITHDRAWAL_EMAIL_COOLDOWN",
      "message": "Withdrawals are temporarily blocked after an email change",
      "retry_after_seconds": 79214
    }
  }
}