Extend

Legacy v0 flow for extending TronSave resource delegations with an API Key — check extendable delegates, then create extend requests.

Legacy API. The v0 endpoints described here are kept for backwards compatibility. New integrations should use the current API Reference instead.

To use this feature you must have an API Key. See Authentication for how to get one and how it is tied to your Internal Account.

The extend flow has two steps:

1. Check extendable delegates — estimate which delegations can be extended, the price, and the total TRX cost.

2. Create the extend request — submit the extend_data from step 1 to actually extend.

A runnable Postman collection for this flow is available: Extend order with API Key.

Step 1: Check all extendable delegates

POST https://api.tronsave.io/v0/get-extendable-delegates

Check extendable delegates with your API Key.

Rate limit: 1 request per 1 second.

Headers

Name	Type	Description
apikey*	String	TronSave API Key tied to your Internal Account

Request Body

Name	Type	Description
extend_to*	String	Time in milliseconds you want to extend to
max_price	Number	Maximum price you want to pay to extend
receiver	String	The address that received the resource delegation

200: OK Success

  {
            "extend_order_book": [
                {
                    "price": 133,
                    "value": 64319
                },
                ...
            ], //Overview extend energy amount at every single price
            "total_delegate_amount": 64319, 
            //Total current delegate of receiver address in tronsave
            "total_available_extend_amount": 64319,
            //Total available delegate of receiver address in tronsave
            "total_estimate_trx": 8554427,
            //Estimate TRX payout if using extend_data below to create extend request
            "your_balance": 20000000,
            //api key's internal balance 
            "is_able_to_extend": true,
            //Compare balance and total_estimate_trx 
            "extend_data": [
                {
                    "delegator": "TMN2uTdy6rQYaTm4A5g732kHRf72tKsA4w",
                    "is_extend": true,
                    "extra_amount": 0,
                    "extend_to": 1728459019000
                }
            ]
            //Extend data that are used to create extend requests below
}

401: Unauthorized Invalid api key

429: Too Many Requests Rate limit reached

The extend_data array in the response is what you pass to Step 2 to create the actual extend requests.

Example

Body

{
    "extend_to":1728704969000,
    "max_price":165,
    "receiver":"TFwUFWr3QV376677Z8VWXxGUAMF11111111"
}

Headers

Success Response

Example code

Javascript

const GetEstimateExtendData = async () => {
    const url = `https://api.tronsave.io/v0/get-extendable-delegates`
    const body = {
        "extend_to": extend_to, //time in milliseconds you want to extend to
        "receiver": RECEIVER,   //the address that receives resource delegate
        "max_price": max_price, //Optional. Number maximum price you want to pay to extend
    }
    const data = await fetch(url, {
            method: "POST",
            headers: {
                'apikey': API_KEY,
                "content-type": "application/json",
            },
            body: JSON.stringify(body)
        })
    const response = await data.json()
        /**
         * Example response:
         {
            "extend_order_book": [
                {
                    "price": 133,
                    "value": 64319
                }
            ],
            "total_delegate_amount": 64319,
            "total_available_extend_amount": 64319,
            "total_estimate_trx": 8554427,
            "is_able_to_extend": true,
            "your_balance": 20000000,
            "extend_data": [
                {
                    "delegator": "TMN2uTdy6rQYaTm4A5g732kHRf72tKsA4w",
                    "is_extend": true,
                    "extra_amount": 0,
                    "extend_to": 1728459019000
                }
            ]
        }
         */
        return response
}

cURL

Step 2: Create an extend request by API Key

POST https://api.tronsave.io/v0/internal-extend-request

Create a new extend request order with your API Key.

Rate limit: 15 requests per 1 second.

Headers

Name	Type	Description
apikey*	String	TronSave API Key tied to your Internal Account

Request Body

Name	Type	Description
receiver*	String	The address that received the resource
extend_data*	Array	Array of extend data. Take it from the response of the estimate extendable delegates API (Step 1)

200: OK Success

Returns an array of order IDs on success.

[<order_id_1>,<order_id_2>,...]

401: Unauthorized Invalid api key

429: Too Many Requests Rate limit reached

Example

Body

{
    "extend_data":[
        {
            "delegator": {{some_delegator_address}},
            "is_extend": true,
            "extra_amount": 0,
            "extend_to": {{extend_timestamp_in_millisecs}}
        },
        ...
    ],
    "receiver":{{receiver_address}}
}

Headers

Success Response

Example code

Javascript

const SendInternalExtendRequest = async () => {
    const url = `https://api.tronsave.io/v0/internal-extend-request`
    const body = {
            "extend_data": [    
                {
                    "delegator": {{some_delegator_address}},
                    "is_extend": true,
                    "extra_amount": 0,
                    "extend_to": {{extend_timestamp_in_millisecs}}
                }
            ],
            "receiver": RECEIVER,
        }
    const data = await fetch(url, {
            method: "POST",
            headers: {
                'apikey': API_KEY,
                "content-type": "application/json",
            },
            body: JSON.stringify(body)
        })
    const response = await data.json()
        /**
         * Example response 
         * @link  //TODO
           [<order_id>]
         */
        return response
    }
    return []
}

cURL

Next steps

• Buy with REST API (v0) — the legacy buy flow.

• API Reference — the current, recommended API.

• Authentication — get and manage your API Key.