步骤 1：获取可扩展的委托人

步骤 1：检查所有可延长的委托

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

速率限制 (Rate limit): 每1秒1个请求。

请求头

名称	类型	描述
apikey*	String	Tronsave API密钥，适用于内部账户

请求体

名称	类型	描述
extendTo*	String	你想要延长的时间（以毫秒为单位）
maxPriceAccepted	Number	你愿意支付的最大延长费用（数字）
receiver*	String	接收资源委托的地址
requester	String	请求者的地址。如果未提供，则从 API 密钥中获取请求者。
resourceType	String	“ENERGY”或“BANDWIDTH”，默认： “ENERGY”

200: OK Success

{
    "extendOrderBook": [
        {
            "price": 133,
            "value": 64319
        },
        ...
    ], // 概述每个价格的扩展能源数量
    "totalDelegateAmount": 64319,
    // 收件人在Tronsave上的当前总委托
    "totalAvailableExtendAmount": 64319,
    // 收件人在Tronsave上的可用总委托
    "totalEstimateTrx": 8554427,
    // 如果使用下面的extend_data创建延长请求，估算的TRX支付
    "yourBalance": 20000000,
    // API密钥的内部余额
    "isAbleToExtend": true,
    // 比较余额和totalEstimateTrx
    "extendData": [
        {
            "delegator": "TMN2uTdy6rQYaTm4A5g732kHRf72tKsA44",
            "isExtend": true,
            "extraSmount": 0,
            "extendTo": 1728459019
        }
    ]
    // 用于创建下面延长请求的扩展数据
}

400: Bad Request Invalid params

401: Unauthorized Invalid api key

429: Too many requests Rate limit reached

示例

请求体

{
    "extendTo":1728704969000,
    "maxPriceAccepted":165,
    "receiver":"TFwUFWr3QV376677Z8VWXxGUAMF11111111",
    "resourceType": "ENERGY"
}

请求头

成功响应

示例代码

Javascript

const GetEstimateExtendData = async (extendTo, maxPriceAccepted) => {
    const url = TRONSAVE_API_URL + `/v2/get-extendable-delegates`
    const body = {
        extendTo, // 要扩展到的时间（秒）
        receiver: RECEIVER, // 接收资源委托的地址
        maxPriceAccepted, // 可选。要支付扩展的最大价格
        resourceType: RESOURCE_TYPE, // ENERGY 或 BANDWIDTH，可选，默认值为 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()
    /**
     * 示例响应
     * @link  
       {
            "error": false,
            "message": "成功",
            "data": {
                "extendOrderBook": [
                    {
                        "price": 784,
                        "value": 1002
                    }
                ],
                "totalDelegateAmount": 5003, // 总委托数量
                "totalAvailableExtendAmount": 5003, // 可扩展的总数量
                "totalEstimateTrx": 4085783, // 预估 TRX 总量
                "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
}

PHP

Python