Freeze balance using FreezeBalanceV2

1 import requests 2 3 url = "https://tron-mainnet.g.alchemy.com/v2/docs-demo/wallet/freezebalancev2" 4 5 payload = { 6 "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g", 7 "frozen_balance": 10000000, 8 "resource": "BANDWIDTH" 9 } 10 headers = {"Content-Type": "application/json"} 11 12 response = requests.post(url, json=payload, headers=headers) 13 14 print(response.json())

1 { 2 "visible": true, 3 "txID": "63b44752122878519d28fa39215c073442d111205b93c7841d1cec92de6bd3c5", 4 "raw_data": { 5 "contract": [ 6 { 7 "parameter": { 8 "value": { 9 "owner_address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g", 10 "frozen_balance": 10000000, 11 "resource": "ENERGY" 12 }, 13 "type_url": "type.googleapis.com/protocol.FreezeBalanceV2Contract" 14 }, 15 "type": "FreezeBalanceV2Contract" 16 } 17 ], 18 "ref_block_bytes": "41ab", 19 "ref_block_hash": "6e4741b021c6afe5", 20 "expiration": 1762275138000, 21 "timestamp": 1762275080550 22 }, 23 "raw_data_hex": "0a0241ab22086e4741b021c6afe540d0b3a2fea4335a5a083612560a34747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e467265657a6542616c616e63655632436f6e7472616374121e0a1541fd49eda0f23ff7ec1d03b52c3a45991c24cd440e1080ade204180170e6f29efea433" 24 }

Freezes TRX tokens in an account to gain ENERGY resources using the newer FreezeBalanceV2 mechanism. This version omits the frozen_duration parameter and is considered an improved alternative to /freezebalance.

Request

This endpoint expects an object.

owner_addressstringRequired

Base58 address of the account to freeze TRX from.

frozen_balanceintegerRequired

Amount to freeze, in SUN (1 TRX = 1,000,000 SUN).

resourceenumRequired

Type of resource to gain from freezing.

Allowed values:

visiblebooleanOptional

Indicates if the address is base58 (true) or hex (false).

Response

Unsigned transaction object for FreezeBalanceV2 operation.

visibleboolean or null

txIDstring or null

raw_dataobject or null

raw_data_hexstring or null

Hex-encoded raw transaction.