Skip to main content

/wallet/freezebalance REST API Endpoint

Stake an amount of TRX to obtain bandwidth or energy, and obtain equivalent TRON Power(TP) according to the staked amount

Updated on
Oct 4, 2023

/wallet/freezebalance REST API Endpoint

Body Parameters

owner_address
string
REQUIRED
The owner address, encoded in hexString
frozen_balance
string
REQUIRED
The TRX stake amount in sun(units)
frozen_duration
integer
REQUIRED
It represents the lock-up duration for a stake in the network. Currently, the allowed value for frozen_duration is set to 3 days. It means that once you stake your tokens, you are not allowed to unstake them until after the 3-day lock-up period has passed.
resource
boolean
REQUIRED
The TRX stake type, it can be BANDWIDTH or ENERGY
receiver_address
boolean
The address that will receive the resource encoded in hexString
permission_id
integer
The ID of the permission that is required to execute the transaction
visible
boolean
A boolean value indicating whether the address is in base58 format

Returns

visible
A boolean value indicating whether the transaction was successful
txid
The transaction id
raw_data
An object that contains the transaction details with the following fields:
contract
An array of objects containing information about the delegate resource contract
parameter
An object containing the delegate resource contract parameters
value
An object containing the values of the delegate resource contract parameters
resource
The type of resource that is being frozen
owner_address
The address of the account for which the balance has been frozen
frozen_balance
The amount of the specified resource (ENERGY) that has been frozen
type_url
The URL of the freeze balance contract type
type
The type of the freeze balance contract
ref_block_bytes
The ref block bytes of the transaction
ref_block_hash
The ref block hash of the transaction
expiration
This is a timestamp indicating the expiration time of the transaction in milliseconds
timestamp
This is a timestamp indicating the time at which the transaction was created in milliseconds
raw_data_hex
The hexadecimal representation of the raw data in the transactio
Request
1
curl https://docs-demo.tron-mainnet.quiknode.pro/wallet/freezebalance \
2
    --header 'accept: application/json' \
3
    --header 'content-type: application/json' \
4
    --data '
5
    {
6
      "owner_address": "OWNER_ADDRESS",
7
      "frozen_balance": 100000,
8
      "frozen_duration": 3,
9
      "resource": "ENERGY",
10
      "visible": true
11
    }
12
'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free