freezebalancev2 - Tron

freezebalancev2. Creates a transaction to freeze TRX for bandwidth or energy under the Stake 2.0 model.

freezebalancev2 - tron [Value: 20CU]
Creates a transaction to freeze TRX for bandwidth or energy under the Stake 2.0 model.
Use cases

Use cases

  • Stake TRX for bandwidth or energy and gain voting rights under Stake 2.0
  • Grow an account's resource capacity ahead of a busy period
Constraints

Constraints

  • Unfreezing (unfreezebalancev2) starts a waiting period before TRX can be withdrawn
  • Voting rights from staked TRX must still be cast separately via votewitnessaccount
Get started
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request POST \
     --url https://lb.drpc.live/tron/{API-KEY}/wallet/freezebalancev2 \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{"owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g", "frozen_balance": 1, "resource": "example", "visible": true}'
Copy
Response
200
{
  "visible": false,
  "txID": "081256264131fbc9f3d4686aab15ae69c0e77b39d276367c11a7ab13e39747ec",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "resource": "ENERGY",
            "frozen_balance": 1000000000,
            "owner_address": "41dd791d6b49e190062d650e6a23c575510d35f2f9"
          },
          "type_url": "type.googleapis.com/protocol.FreezeBalanceV2Contract"
        },
        "type": "FreezeBalanceV2Contract"
      }
    ],
    "ref_block_bytes": "283b",
    "ref_block_hash": "51bf0b88daaaea37",
    "expiration": 1777446819000,
    "timestamp": 1777446761432
  },
  "raw_data_hex": "0a02283b220851bf0b88daaaea3740b8a9d8c0dd335a5b083612570a34747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e467265657a6542616c616e63655632436f6e7472616374121f0a1541dd791d6b49e190062d650e6a23c575510d35f2f9108094ebdc03180170d8e7d4c0dd33"
}
Copy

Request params

idinteger
jsonrpcstring
methodstring
Parametersobject
object
visibleboolean
Indicates whether addresses in this transaction are represented in base58 format (true) or hex format (false).
owner_addressstring
[Required] Freezing account address
frozen_balanceint64
[Required] Frozen amount (sun)
resourceenum
BANDWIDTH / ENERGY / TRON_POWER, default BANDWIDTH
Permission_idinteger
Multi-sig permission ID

Response

200
Creates a transaction to freeze TRX for bandwidth or energy under the Stake 2.0 model.

Response params

object
visibleboolean
Indicates whether addresses in this transaction are represented in base58 format (true) or hex format (false).
txIDstring
The unique transaction hash (transaction ID), computed as the SHA256 of raw_data.
raw_dataobject
The unsigned transaction body containing the contract instruction and blockchain reference data.
object
contractarray_of_objects
The list of contract instructions to be executed by this transaction.
object
parameterobject
The typed payload describing the specific contract call being made.
object
valueobject
The decoded fields of the contract — here, a Stake 2.0 freeze request.
object
resourcestring
The resource type being staked for, either BANDWIDTH or ENERGY.
frozen_balanceinteger
The amount of TRX, in sun, to freeze (stake) for the specified resource.
owner_addressstring
The address performing the freeze, in hex format.
type_urlstring
The fully qualified protobuf type identifier describing which contract schema `value` should be decoded with.
typestring
The human-readable name of the contract type being executed (here, FreezeBalanceV2Contract).
ref_block_bytesstring
The last two bytes of the reference block number, used for transaction expiration and replay protection.
ref_block_hashstring
The last eight bytes of the reference block's hash, paired with ref_block_bytes for replay protection.
expirationinteger
Unix timestamp, in ms, after which this transaction is no longer valid and will be rejected by the network.
timestampinteger
Unix timestamp, in ms, marking when the transaction was created/signed by the client.
raw_data_hexstring
The hex-encoded serialized bytes of raw_data, used as the actual payload to sign and broadcast.
Freeze BalanceUnfreeze Balance