Withdrawals

​

Create Withdrawal

​

Request body

​

Headers

​

Retrying safely

• The same key with the same to_address, amount_trx and currency returns 200 with the withdrawal the first request created, as it stands now. Nothing is charged twice.
• The same key with a different body is refused with 422 and the code IDEMPOTENCY_KEY_REUSED; a key longer than 64 characters — with 422 and IDEMPOTENCY_KEY_TOO_LONG. Keys are scoped to your account and do not expire — never reuse one for another withdrawal.
• One unsettled withdrawal (pending, scheduled or processing) at a time: another request while one is unsettled gets 400 with You already have a pending withdrawal.
• After a withdrawal created with Idempotency-Key, the next one may be created in 5 seconds; without the header the pause stays 60 seconds (429, see Rate limits).

​

Example

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

​

List Withdrawals

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

​

Withdrawal statuses

​

Security hold after an email change

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