Tron Unstake - Finrock

curl --request POST \
     --url https://api.finrock.io/dac/v1/tron/unstake \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: {{api_key}}' \
     --header 'Authorization: Token {JWT}' \
     --data '
{
  "asset": "TRX",
  "address": "TYourTronAddressHere",
  "resource": "ENERGY",
  "amount": 100
}
'

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "Pending",
  "unsigned_data": null
}

{
  "id": "na",
  "status": "None",
  "unsigned_data": "eyJzYV9ndWlkIjoi..."
}

POST

dac

tron

unstake

curl --request POST \
     --url https://api.finrock.io/dac/v1/tron/unstake \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: {{api_key}}' \
     --header 'Authorization: Token {JWT}' \
     --data '
{
  "asset": "TRX",
  "address": "TYourTronAddressHere",
  "resource": "ENERGY",
  "amount": 100
}
'

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "Pending",
  "unsigned_data": null
}

{
  "id": "na",
  "status": "None",
  "unsigned_data": "eyJzYV9ndWlkIjoi..."
}

MCP scope: dac.funds (not available to AI connectors yet) When you no longer need the ENERGY or BANDWIDTH resources provided by staked TRX — or when you want to reallocate your TRX — use this endpoint to initiate the unstaking process. After submitting an unstake request, the TRX enters a cooldown period defined by the Tron protocol. During this time the resources are released but the TRX is not yet available for transfers. Once the cooldown completes, use the Release Unstaked TRX endpoint to return the funds to your available balance.

Body Parameters

Method: POST
URL: https://api.finrock.io/dac/v1/tron/unstake

Body Parameters

string

default:"TRX"

required

The blockchain ticker. Must be TRX.

string

required

The Tron address from which you want to unstake TRX. This must be the address where you previously staked via the Stake TRX endpoint.

string

default:"ENERGY"

required

The resource type associated with the TRX you want to unstake. Must match what was staked:

ENERGY — unstake TRX that was staked for ENERGY
BANDWIDTH — unstake TRX that was staked for BANDWIDTH

number

default:"100"

required

The amount of TRX to unstake, expressed as a decimal number. Must not exceed the amount currently staked for the specified resource on this address.

curl --request POST \
     --url https://api.finrock.io/dac/v1/tron/unstake \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: {{api_key}}' \
     --header 'Authorization: Token {JWT}' \
     --data '
{
  "asset": "TRX",
  "address": "TYourTronAddressHere",
  "resource": "ENERGY",
  "amount": 100
}
'

Response

A 200 response confirms the unstaking has been initiated and the TRX is now in the cooldown period.

string

The Finrock transaction ID of the unstaking 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.

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "Pending",
  "unsigned_data": null
}

{
  "id": "na",
  "status": "None",
  "unsigned_data": "eyJzYV9ndWlkIjoi..."
}

During the Tron cooldown period, the unstaked TRX is neither available for transfer nor earning resources. Plan your unstaking operations in advance to avoid gaps in resource coverage for high-volume addresses.