Skip to main content
After initiating an unstake via the Unstake TRX endpoint and waiting for the Tron protocol’s cooldown period to complete, your TRX is ready to be released back to your available wallet balance. Use this endpoint to execute the final step in the unstaking flow and make the TRX transferable again. You must call this endpoint explicitly — TRX does not automatically return to your balance when the cooldown expires.

Request

Method: POST
URL: https://api.finrock.io/dav/v1/release-unstaked

Body Parameters

string
default:"TRX"
required
The blockchain ticker. Must be TRX.
string
required
The Tron address from which you previously unstaked TRX and want to release the cooldown funds back to an available balance.

Headers

string
required
Your Finrock API key.
string
required
Your JWT bearer token. Format: Token {JWT}

Example Request

Response

A 200 response confirms that the TRX has been successfully released and returned to the available balance of the specified address. A 400 response indicates the cooldown has not yet completed or no unstaked TRX is pending release for this address.
object
Confirms the TRX has been released. The funds are now available for transfers and transactions.
object
Returned when there is no TRX available for release, the cooldown has not yet expired, or the address is invalid.

The Full Tron Staking Lifecycle

1

Stake TRX

Call POST /dav/v1/stake to lock TRX and allocate ENERGY or BANDWIDTH to a Tron address.
2

Use your resources

Your staked address benefits from reduced or zero-cost transactions for as long as the TRX remains staked.
3

Initiate unstaking

Call POST /dav/v1/unstake to begin the cooldown period. Resources are released immediately but TRX is still locked.
4

Wait for cooldown

The Tron protocol enforces a cooldown period (typically around 14 days) before staked TRX can be withdrawn.
5

Release unstaked TRX

Once the cooldown completes, call this endpoint to return the TRX to your available balance.