步骤 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

{
    "MISSING_PARAMS": "请求体中缺少某些参数",
    "INVALID_PARAMS": "某些参数无效"
}

401: Unauthorized Invalid api key

{
    "API_KEY_REQUIRED": "请求头中缺少API密钥",
    "INVALID_API_KEY": "API密钥不正确"
}

429: Too many requests Rate limit reached

{
    "RATE_LIMIT": "已达到速率限制"
}

示例

请求体

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

请求头

{
  "apikey": <YOUR_API_KEY>
}

成功响应

{
    "extendOrderBook": [
        {
            "price": 108,
            "value": 100000
        },
        {
            "price": 122,
            "value": 200000
        }
    ],
    "totalDelegateAmount": 500000,
    "totalAvailableExtendAmount": 300000,
    "totalEstimateTrx": 24426224,
    "isAbleToExtend": true,
    "yourBalance": 37780396,
    "extendData": [
        {
            "delegator": "TQBV7xU489Rq8ZCsYi72zBhJM2222222",
            "isExtend": true,
            "extraAmount": 0,
            "extendTo": 1728704969000
        },
        {
            "delegator": "TMN2uTdy6rQYaTm4A5g732kHR333333333",
            "isExtend": true,
            "extraAmount": 0,
            "extendTo": 1728704969000
        }
    ]
}

示例代码

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

function getEstimateExtendData(int $extendTo, int $maxPriceAccepted): array {
    $url = TRONSAVE_API_URL . "/v2/get-extendable-delegates";
    $body = [
        'extendTo' => $extendTo,
        'receiver' => RECEIVER,
        'maxPriceAccepted' => $maxPriceAccepted,
        'resourceType' => RESOURCE_TYPE,
    ];

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'apikey: ' . API_KEY,
        'Content-Type: application/json'
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

Python

def get_estimate_extend_data(extend_to: int, max_price_accepted: int) -> Dict[str, Any]:
    """Get estimate extend data"""
    url = f"{TRONSAVE_API_URL}/v2/get-extendable-delegates"
    headers = {
        'apikey': API_KEY,
        'Content-Type': 'application/json'
    }
    
    body = {
        'extendTo': extend_to,
        'receiver': RECEIVER,
        'maxPriceAccepted': max_price_accepted,
        'resourceType': RESOURCE_TYPE,
    }
    
    response = requests.post(url, headers=headers, json=body)
    return response.json()