Stake TRX

Use Case

Stakes TRX for energy or bandwidth resources on Tron. Applies to Tron gas stations only.

Stake TRX

Request Body
1
amountstringRequired

TRX amount to stake (numeric, > 0).

2
resourcestringRequired

`ENERGY` (for smart-contract calls / TRC-20 transfers) or `BANDWIDTH` (for native TRX transfers).

Example Payload

Unstake TRX

Use Case

Unstakes TRX. Subject to the 14-day unlock period (Tron Stake 2.0) — the TRX returns to the gas station's liquid balance once the unlock period elapses.

Unstake TRX

Request Body
1
amountstringRequired

TRX amount to unstake (numeric, > 0). Must not exceed the currently staked amount for `resource`.

2
resourcestringRequired

`ENERGY` or `BANDWIDTH` — matches the resource the original stake was made under.

Example Payload

List Stakes

Use Case

Returns active and unlocking TRX stakes for this gas station.

List Stakes

List Stakes Response
1
resourcestring

Which resource this stake produces — `ENERGY` or `BANDWIDTH`.

2
amount_trxstring

Display amount of TRX locked in this stake.

3
estimated_resourceinteger

Estimated energy / bandwidth gain this stake yields at the current network rate.

4
statusstring

`active` while the stake is producing resources; `unlocking` after an unstake is initiated.

5
unlocks_atstring (RFC3339)

When the unstake completes and the TRX returns to the gas station's liquid balance. Set only when `status = unlocking`.

List Stakes Response

Get Stake Estimate

Use Case

Previews the resource gain for a given stake amount before actually staking.

Get Stake Estimate

Query Parameters
1
amountstring

TRX amount you're considering staking.

2
resourcestring

`ENERGY` or `BANDWIDTH` — picks which conversion rate the estimate uses.

Query

Stake Estimate Response
1
resourcestring

Echo of the requested `resource` (`ENERGY` or `BANDWIDTH`).

2
amount_trxstring

Echo of the requested TRX amount.

3
ratestring

Current conversion rate (e.g., `20 energy/TRX`). Drives the estimate.

4
estimated_resource_gaininteger

Projected resource units this stake would produce.

5
unlock_period_daysinteger

Lock period before the stake can be reclaimed (14 days for Tron Stake 2.0).

Stake Estimate Response

Tron Delegation

Use Case

Delegate staked TRX energy or bandwidth to another Tron account, and reclaim it later.


Delegate Resources

Use Case

Delegates staked TRX energy or bandwidth to another Tron account.

Delegate Resources

Request Body
1
receiver_addressstringRequired

Tron address that will be able to spend the delegated energy / bandwidth.

2
amountstringRequired

TRX amount (numeric, > 0) being delegated.

3
resourcestringRequired

`ENERGY` or `BANDWIDTH` — must match a resource you've staked for.

4
lockboolean

When `true`, the delegation cannot be revoked until `lock_period_days` passes.

5
lock_period_daysinteger

Lock period in days (minimum 3). Only used when `lock = true`.

Example Payload

Undelegate Resources

Use Case

Reclaims previously delegated energy or bandwidth back to this gas station's staked balance.

Undelegate Resources

Request Body
1
receiver_addressstringRequired

Tron address you're reclaiming the delegation from.

2
amountstringRequired

TRX amount (numeric, > 0) to reclaim.

3
resourcestringRequired

`ENERGY` or `BANDWIDTH` — matches the delegation you're undoing.

Example Payload

List Delegations

Use Case

Returns active resource delegations for this gas station.

List Delegations

List Delegations Response
1
receiver_addressstring

Tron address that currently benefits from the delegated resource.

2
resourcestring

`ENERGY` or `BANDWIDTH` — which staked resource is being lent out.

3
amount_trxstring

Amount of TRX (in staked terms) currently delegated to the receiver.

4
lockedboolean

`true` when the delegation is locked and cannot be revoked yet.

5
lock_expires_atstring (RFC3339)

When the lock period ends and the delegation becomes revocable. Empty when `locked = false`.

List Delegations Response
Did you find this page useful?