Jump to
Ctrl
+
/

Tron Resource Management

POST
/vaults/{vaultId}/{blockchain}/{network}/addresses/{fromAddress}/manage-resource

Through this endpoint, users can manage TRX staking: freezing, unfreezing, and withdrawing TRX. Stake an amount of TRX to obtain bandwidth or energy and optimize blockchain resource usage. Additionally, users can delegate bandwidth or energy resources to other accounts for efficient transaction processing.

Path Parameters

blockchain string Required

Specifies the blockchain network involved in the transaction (eg. tron).

fromAddress string Required

Represents the originating address from which the transaction is initiated.

network string Required

Specifies the network used (eg. mainnet , nile).

vaultId string Required

Represents the sender's specific and unique Vault ID of the sender.

Query Parameters

context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

Request Body Schema application/json

context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

data object Required
item object Required
amount string Required

The amount of TRX which will be freeze/unfreeze/delegate/undelegate. When type of request is withdraw-resource the amount is not required.

lock string Optional

Boolean if we want to lock the delegated amount. Whether to lock the resource delegation, true means locked the delegation, the delegating cannot be canceled within the period specified by lockPeriod, false means non-locked, the resource delegating can be canceled at any time.

lockPeriod string Optional

Only when lock is true, this field is valid. If the delegate lock period is 1 day, the lock_period is: 28800. The minimum value of lockPeriod is the remaining lock period of this type of resource that was delegated last time, and the maximum value is 864000 (30 days). If lock is true and lock_period is not set or set to 0, lockPeriod will be set to the default value 86400 (3 days) automatically.

note string Optional

Transaction note with additional details.

resource string Required

Resource staking for (e.g. Bandwidth, Energy).

toAddress string Optional

Address receiving the delegated amount or from which we undelegate. It is used when type of the request is delegate/undelagate.

type string Required

Type of the request (e.g. freeze, unfreeze, withdraw-resource)

Response Schema

apiVersion string Required

Specifies the version of the API that incorporates this endpoint.

2024-05-09
requestId string Required

Defines the ID of the request. The requestId is generated by Vaultody and it's unique for every request.

601c1710034ed6d407996b30
context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

yourExampleString
data object Required
item object Required
blockchain string Required

Specifies the blockchain network involved in the transaction. (eg. tron).

tron
destination array Items (object) Required

Destination of the transaction

address string Required

Address of the destination that will receive the resources.

TMLmaAS4GfshG6PfToD5YYRm5G8giauYc4
amount string Required

The amount of TRX being staked/unfrozen.

3
amountUnit string Required

The unit of currency used in the transaction.

TRX
id string Required

A unique identifier for the transaction.

67a336950ca2f4fd25fb0deb
network string Required

Specifies the network used (eg. mainnet, nile).

mainnet
resource string Required

Specifies the type of the resource being managed(eg. bandwidth, energy).

energy
source object Required

Details about the sender

address string Required

The address of the sender.

TMLmaAS4GfshG6PfToD5YYRm5G8giauYc4
status string Required

Defines the status of the transaction request, (e.g. created).

created
type string Required

The type of staking operation being performed (eg. freeze, unfreeze, withdraw-resource)

freeze
vaultId string Required

Identifies the vault id linked to the transaction.

66d9b73a9f455b085ed9de39
Was this page helpful?
Yes
No
Powered by
Language
URL

{
    "apiVersion": "2024-05-09",
    "requestId": "601c1710034ed6d407996b30",
    "context": "yourExampleString",
    "data": {
        "item": {
            "blockchain": "tron",
            "destination": [
                {
                    "address": "TMLmaAS4GfshG6PfToD5YYRm5G8giauYc4",
                    "amount": "3",
                    "amountUnit": "TRX"
                }
            ],
            "id": "67a336950ca2f4fd25fb0deb",
            "network": "mainnet",
            "resource": "energy",
            "source": {
                "address": "TMLmaAS4GfshG6PfToD5YYRm5G8giauYc4"
            },
            "status": "created",
            "type": "freeze",
            "vaultId": "66d9b73a9f455b085ed9de39"
        }
    }
}