v2 — Extend with API Key

Full working example showing how to extend an existing TronSave order using an API Key, in JavaScript, PHP, and Python.

This is a complete, runnable example for extending an existing order on TronSave using an API Key. It calls the v2 extend endpoints in two steps: first it estimates which delegates are extendable and how much TRX it will cost, then it submits the extend request and returns an orderId.

Prerequisites

You need a TronSave API Key tied to an Internal Account. There are two ways to obtain one:

• Option 1: Generate the API Key on the TronSave website.

• Option 2: Generate the API Key on Telegram.

See Authentication for both methods and details on how the API Key authorizes requests against your Internal Account.

The JavaScript example below uses only the built-in fetch API and does not require TronWeb. The original source noted a TronWeb 5.3.2 requirement for related examples; install it only if your wider integration needs signing:

npm i [email protected] @noble/[email protected]

Read more in the TronWeb 5.3.2 release notes.

How it works

The flow uses two endpoints:

1. /v2/get-extendable-delegates — returns the extendData payload, the estimated TRX cost, and whether the extension is possible.

2. /v2/extend-request — submits the extendData and returns an orderId.

Set these variables before running:

Variable	Description
API_KEY	Your TronSave API Key.
RECEIVER	The address that receives the resource delegate.
RESOURCE_TYPE	ENERGY or BANDWIDTH. Optional; defaults to ENERGY.
extendTo	The time, in seconds (Unix timestamp), you want to extend the delegation to.
maxPriceAccepted	Optional. The maximum price (in SUN) you are willing to pay to extend.

Full example

JavaScript

const API_KEY = `your-api-key`;
const TRONSAVE_API_URL = "https://api.tronsave.io"
const RECEIVER = "your-receiver-address"
const RESOURCE_TYPE = "ENERGY"

const GetEstimateExtendData = async (extendTo, maxPriceAccepted) => {
    const url = TRONSAVE_API_URL + `/v2/get-extendable-delegates`
    const body = {
        extendTo, //time in seconds you want to extend to
        receiver: RECEIVER,   //the address that receives the resource delegate
        maxPriceAccepted, //Optional. Number the maximum price you want to pay to extend
        resourceType: RESOURCE_TYPE, //ENERGY or BANDWIDTH. optional. The default is ENERGY
    }
    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  
       {
            "error": false,
            "message": "Success",
            "data": {
                "extendOrderBook": [
                    {
                        "price": 784,
                        "value": 1002
                    }
                ],
                "totalDelegateAmount": 5003,
                "totalAvailableExtendAmount": 5003,
                "totalEstimateTrx": 4085783,
                "isAbleToExtend": true,
                "yourBalance": 2377366851,
                "extendData": [
                    {
                        "delegator": "TGGVrYaT8Xoos...6dmSZkohGGcouYL4",
                        "isExtend": true,
                        "extraAmount": 0,
                        "extendTo": 1745833276
                    },
                    {
                        "delegator": "TQBV7xU489Rq8Z...zBhJMdrDr51wA2",
                        "isExtend": true,
                        "extraAmount": 0,
                        "extendTo": 1745833276
                    },
                    {
                        "delegator": "TSHZv6xsYHMRCbdVh...qNozxaPPjDR6",
                        "isExtend": true,
                        "extraAmount": 0,
                        "extendTo": 1745833276
                    }
                ]
            }
        }
     */
    return response
}

/**
 * @param {number} extendTo the time in seconds you want to extend to
 * @param {boolean} maxPriceAccepted number maximum price you want to pay to extend
 * @returns 
 */
const SendExtendRequest = async (extendTo, maxPriceAccepted) => {
    const url = TRONSAVE_API_URL + `/v2/extend-request`
    // Get estimate extendable delegates
    const estimateResponse = await GetEstimateExtendData(extendTo, maxPriceAccepted)
    const extendData = estimateResponse.data?.extendData
    if (extendData && extendData.length) { 
        const body = {
            extendData: extendData,
            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 
         {
            error: false,
            message: 'Success',
            data: { orderId: '680b5ac7b09a385fb3d582ff' }
            }
         */
        return response
    }
    return []
}

//Example run code
const ClientCode = async () => { 
    const extendTo = Math.floor(new Date().getTime() / 1000) + 3 * 86400 //Extend to 3 next days
    const maxPriceAccepted = 900
    const response = await SendExtendRequest(extendTo, maxPriceAccepted)
    console.log(response)
}


ClientCode()

PHP

Python

Next steps

• Get Extendable Delegates — full reference for step 1.

• Submit Extend Request — full reference for step 2.

• Authentication — how to obtain and use an API Key.