UnfreezeBalanceV2

Unstake some TRX staked in Stake2.0, release the corresponding amount of bandwidth or energy, and voting rights (TP).

This method will use 30 Compute Units.

---

Unlock the TRX staked at the Stake 2.0 stage through this interface. After unstaking, the user needs to wait for 14 days before calling the /wallet/withdrawexpireunfreeze interface to withdraw the funds of this unstaking.

When executing unstaking, if there is a previously unstaked funds that has passed the lock-up period, then this unstaking operation will also withdraw the unstaked funds that has passed the lock-up period to the account at the same time. You can query the amount of funds withdrawn in this transaction through gettransactioninfobyid API.

Parameters

• owner_address - String, required - Owner address, default hexString

• unfreeze_balance - int64, required - The amount of TRX to unstake, in sun

• resource - String, required - TRX stake type, 'BANDWIDTH' or 'ENERGY'

• Permission_id - int32 - Optional, for multi-signature use

• visible - Boolean - Optional. Specifies whether the address is in Base58 format (default: false).

Returns

Transaction object - JSON object: Unsigned transaction, please refer to the Transaction chapter for the fields contained in it. Since the transaction type is UnfreezeBalanceV2Contract, the fields contained in raw_data.contract[0].parameter.value in the transaction are as follows:

Field	Type	Description
owner_address	string	Account address
resource	string	Resource type
unfreeze_balance	int64	Unstake amount, unit is sun

// Result
{
  "visible": true,
  "txID": "473bbb59203742c76b1ecbf2e0a5bc3962f37167ece01261d6680c9c8fcbe290",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "resource": "ENERGY",
            "frozen_balance": 10000000,
            "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g"
          },
          "type_url": "type.googleapis.com/protocol.FreezeBalanceV2Contract"
        },
        "type": "FreezeBalanceV2Contract"
      }
    ],
    "ref_block_bytes": "5abf",
    "ref_block_hash": "137f27cb4608aa7d",
    "expiration": 1756821201000,
    "timestamp": 1756821142996
  },
  "raw_data_hex": "0a025abf2208137f27cb4608aa7d40e8c0d0d590335a5a083612560a34747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e467265657a6542616c616e63655632436f6e7472616374121e0a1541fd49eda0f23ff7ec1d03b52c3a45991c24cd440e1080ade204180170d4fbccd59033"
}

mainnet

curl https://mainnet.tron.validationcloud.io/v1/<YOUR_API_KEY_HERE>/wallet/unfreezebalancev2 \
    -X POST \
    -H "Content-Type: application/json" \
    -d '
{
  "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "unfreeze_balance": 1000000,
  "resource": "BANDWIDTH",
  "visible": true
}
'