Skip to main content
POST
MCP scope: dac.funds (not available to AI connectors yet) 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.

Body Parameters

Method: POST
URL: https://api.finrock.io/dac/v1/tron/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.
string
default:"ENERGY"
The resource type the TRX was staked for: ENERGY or BANDWIDTH.

Response

A 200 response confirms that the TRX has been successfully released and returned to the available balance of the specified address.
string
The Finrock transaction ID of the release transaction. Track it with List Transactions.
string
Initial transaction status, usually Pending. See Transaction Statuses.
string | null
null for most wallets. For an HSM wallet, a Base64-encoded unsigned transaction to sign offline; in that case id is na and status is None. None only appears in this HSM response, never in transaction lists.

The Full Tron Staking Lifecycle

1

Stake TRX

Call POST /dac/v1/tron/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 /dac/v1/tron/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.