延长

使用 API 密钥延长 TronSave 资源代理的 v0 旧版流程 —— 先检查可延长的代理，然后创建延长请求。

旧版 API。 此处描述的 v0 端点为向后兼容而保留。新的集成应改用当前的 API 参考。

要使用此功能，您必须拥有 API 密钥。有关如何获取 API 密钥以及它如何与您的内部账户绑定，请参阅身份验证。

延长流程包含两个步骤：

1. 检查可延长的代理 —— 预估哪些代理可以延长、价格以及总 TRX 成本。

2. 创建延长请求 —— 提交第 1 步中得到的 extend_data 以实际执行延长。

此流程提供了可运行的 Postman 集合：使用 API 密钥延长订单。

第 1 步：检查所有可延长的代理

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

使用您的 API 密钥检查可延长的代理。

速率限制：每 1 秒 1 次请求。

Headers

Name	Type	Description
apikey*	String	与您的内部账户绑定的 TronSave API 密钥

Request Body

Name	Type	Description
extend_to*	String	您希望延长到的时间（以毫秒为单位）
max_price	Number	您愿意为延长支付的最高价格
receiver	String	接收资源代理的地址

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: 未授权 Invalid api key

{
    "API_KEY_REQUIRED": "Missing api key in headers",
    "INVALID_API_KEY":"api key not correct"
}

429: 请求过多 Rate limit reached

{
    "RATE_LIMIT": "Rate limit reached",
}

响应中的 extend_data 数组就是您在第 2 步中用来创建实际延长请求的内容。

示例

Body

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

Headers

{
  "apikey": <YOUR_API_KEY>
}

成功响应

{
    "extend_order_book": [
        {
            "price": 108,
            "value": 100000
        },
        {
            "price": 122,
            "value": 200000
        }
    ],
    "total_delegate_amount": 500000,
    "total_available_extend_amount": 300000,
    "total_estimate_trx": 24426224,
    "is_able_to_extend": true,
    "your_balance": 37780396,
    "extend_data": [
        {
            "delegator": "TQBV7xU489Rq8ZCsYi72zBhJM2222222",
            "is_extend": true,
            "extra_amount": 0,
            "extend_to": 1728704969000
        },
        {
            "delegator": "TMN2uTdy6rQYaTm4A5g732kHR333333333",
            "is_extend": true,
            "extra_amount": 0,
            "extend_to": 1728704969000
        }
    ]
}

示例代码

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

curl --location 'https://api.tronsave.io/v0/get-extendable-delegates' \
--header 'apikey: {{apikey}}' \
--data '
{
 "extend_to": {{extend_timestamp_in_millisecs}}, 
 "receiver": {{receiver_address}},   
 "max_price": {{max_price_per_unit_want_to_pay}}, 
}
'

第 2 步：使用 API 密钥创建延长请求

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

使用您的 API 密钥创建一个新的延长请求订单。

速率限制：每 1 秒 15 次请求。

Headers

Name	Type	Description
apikey*	String	与您的内部账户绑定的 TronSave API 密钥

Request Body

Name	Type	Description
receiver*	String	接收资源的地址
extend_data*	Array	延长数据数组。取自预估可延长代理 API（第 1 步）的响应

200: OK Success

成功时返回订单 ID 数组。

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

401: 未授权 Invalid api key

{
    "API_KEY_REQUIRED": "Missing api key in headers",
    "INVALID_API_KEY":"api key not correct"
}

429: 请求过多 Rate limit reached

{
    "RATE_LIMIT": "Rate limit reached",
}

示例

Body

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

Headers

{
  "apikey": <YOUR_API_KEY>
}

成功响应

["651d2306e55c073f6ca0992e","651d2306e55c073f6ca09923",...]

示例代码

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

curl --location 'https://api.tronsave.io/v0/internal-extend-request' \
--header 'apikey: {{apikey}}' \
--data '
{
    "extend_data":[
        {
            "delegator": {{some_delegator_address}},
            "is_extend": true,
            "extra_amount": 0,
            "extend_to": {{extend_timestamp_in_millisecs}}
        },
        ...
    ],
    "receiver":{{receiver_address}}
}
'

后续步骤

• 使用 REST API 购买（v0） —— 旧版购买流程。

• API 参考 —— 当前推荐使用的 API。

• 身份验证 —— 获取并管理您的 API 密钥。