Retiros

​

Crear retiro

​

Cuerpo de la solicitud

​

Encabezados

​

Reintentos seguros

• La misma clave con los mismos to_address, amount_trx y currency devuelve 200 con el retiro que creó la primera solicitud, en su estado actual. No se cobra dos veces.
• La misma clave con otro cuerpo se rechaza con 422 y el código IDEMPOTENCY_KEY_REUSED; una clave de más de 64 caracteres, con 422 y IDEMPOTENCY_KEY_TOO_LONG. Las claves son propias de tu cuenta y no caducan: nunca reutilices una para otro retiro.
• Un solo retiro sin completar (pending, scheduled o processing) a la vez: otra solicitud mientras exista recibe 400 con You already have a pending withdrawal.
• Tras un retiro creado con Idempotency-Key, el siguiente puede crearse a los 5 segundos; sin el encabezado la pausa sigue siendo de 60 segundos (429, consulta Límites de solicitudes).

​

Ejemplo

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 retiros

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"
  }
]

​

Estados del retiro

​

Bloqueo de seguridad tras cambiar el correo electrónico

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