POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
freezebalancev2
wallet/freezebalancev2
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/freezebalancev2 \
  --header 'Content-Type: application/json' \
  --data '{
  "owner_address": "41608f8da72479edc7dd921e4c30bb7e7cddbe722e",
  "frozen_balance": 1000000,
  "resource": "BANDWIDTH",
  "visible": false
}'
{
  "visible": true,
  "txID": "<string>",
  "raw_data": {
    "contract": [
      "<any>"
    ],
    "ref_block_bytes": "<string>",
    "ref_block_hash": "<string>",
    "expiration": 123,
    "timestamp": 123
  },
  "raw_data_hex": "<string>"
}
TRON API method that stakes TRX for resources using the new staking mechanism. This method freezes TRX tokens to obtain bandwidth or energy resources with improved flexibility, including the ability to unfreeze resources at any time.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

  • owner_address — the address that owns the TRX to freeze (hex format)
  • frozen_balance — the amount of TRX to freeze (in sun, where 1 TRX = 1,000,000 sun)
  • resource — the resource type to obtain (“BANDWIDTH” or “ENERGY”)
  • visible — optional boolean to specify address format (default: false for hex format)

Response

  • visible — boolean indicating address format used
  • txID — transaction ID hash
  • raw_data — raw transaction data object containing freeze contract details
  • raw_data_hex — hexadecimal representation of raw transaction data

Use case

The wallet/freezebalancev2 method is used for:
  • Staking TRX to obtain bandwidth for free transactions using the new mechanism.
  • Freezing TRX to get energy for smart contract execution with improved flexibility.
  • Taking advantage of the ability to unfreeze resources without waiting periods.
  • Implementing modern TRON staking in wallets and DApps with better resource management.

Body

application/json
owner_address
string
default:41608f8da72479edc7dd921e4c30bb7e7cddbe722e
required
frozen_balance
integer
default:1000000
required
resource
enum<string>
default:BANDWIDTH
required
Available options:
BANDWIDTH,
ENERGY
visible
boolean
default:false

Response

200 - application/json

Freeze balance v2 transaction

visible
boolean
txID
string
raw_data
object
raw_data_hex
string