> For the complete documentation index, see [llms.txt](https://docs.tronsave.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tronsave.io/chinese/developers/api-reference/extend-orders/get-extendable-delegates.md). # 获取可延长的代理 这是 v2 延期流程的第 1 步。给定一个 `receiver` 接收地址和目标 `extendTo` 时间，该端点会返回仍然可以延期的代理（委托）、预估的 TRX 费用，以及一个 `extendData` 数组。使用该 `extendData` 来构建 [提交延期请求](/chinese/developers/api-reference/extend-orders/extend-request.md) 的负载。 **`POST`** **`https://api.tronsave.io/v2/get-extendable-delegates`** {% hint style="info" %} 速率限制：每 **1** 秒 **1** 次请求。 {% endhint %} ## 请求头
名称类型说明
apikey*String与你的内部账户绑定的 TronSave API 密钥。参见 身份验证 以获取你的 API 密钥。
\* 必填。 ## 请求体
字段类型说明
extendTo*String你希望延期到的时间（以秒为单位）。
receiver*String接收资源代理（委托）的地址。
requesterString请求方的地址。如果未提供，则从 API 密钥 中获取请求方。
resourceTypeString"ENERGY" 或 "BANDWIDTH"。默认值："ENERGY"。
maxPriceAcceptedNumber你愿意为延期支付的最高价格。
\* 必填。 ### 请求体示例 ```json { "extendTo": 1728704969000, "maxPriceAccepted": 165, "receiver": "TFwUFWr3QV376677Z8VWXxGUAMF11111111", "resourceType": "ENERGY" } ``` ## 响应 {% tabs %} {% tab title="200: Success" %} ```javascript { "extendOrderBook": [ { "price": 133, "value": 64319 }, ... ], // Overview of the extendable resource amount at every single price "totalDelegateAmount": 64319, // Total current delegate of the receiver address in TronSave "totalAvailableExtendAmount": 64319, // Total available delegates of the receiver address in TronSave "totalEstimateTrx": 8554427, // Estimated TRX payout if using the extendData below to create the extend request "yourBalance": 20000000, // API key's internal balance "isAbleToExtend": true, // Compares internal balance and totalEstimateTrx "extendData": [ { "delegator": "TMN2uTdy6rQYaTm4A5g732kHRf72222222", "isExtend": true, "extraAmount": 0, "extendTo": 1728459019 } ] // extendData that is used to create the extend request in Step 2 } ``` {% endtab %} {% tab title="400: 请求错误" %} ```json { "MISSING_PARAMS": "Missing some params in body", "INVALID_PARAMS": "Some params are invalid" } ``` {% endtab %} {% tab title="401: 未授权" %} ```json { "API_KEY_REQUIRED": "Missing api key in headers", "INVALID_API_KEY": "api key not correct" } ``` {% endtab %} {% tab title="429: 请求过多" %} ```json { "RATE_LIMIT": "Rate limit reached" } ``` {% endtab %} {% endtabs %} ### 成功响应示例 ```json { "extendOrderBook": [ { "price": 108, "value": 100000 }, { "price": 122, "value": 200000 } ], "totalDelegateAmount": 500000, "totalAvailableExtendAmount": 300000, "totalEstimateTrx": 24426224, "isAbleToExtend": true, "yourBalance": 37780396, "extendData": [ { "delegator": "TQBV7xU489Rq8ZCsYi72zBhJM44444444", "isExtend": true, "extraAmount": 0, "extendTo": 1728704969000 }, { "delegator": "TMN2uTdy6rQYaTm4A5g732kHR333333333", "isExtend": true, "extraAmount": 0, "extendTo": 1728704969000 } ] } ``` ## 请求示例 {% tabs %} {% tab title="cURL" %} ```bash curl -X POST "https://api.tronsave.io/v2/get-extendable-delegates" \ -H "apikey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "extendTo": 1728704969000, "maxPriceAccepted": 165, "receiver": "YOUR_TRON_ADDRESS", "resourceType": "ENERGY" }' ``` {% endtab %} {% tab title="JavaScript" %} ```javascript const getExtendableDelegates = async () => { const url = "https://api.tronsave.io/v2/get-extendable-delegates"; const body = { extendTo: 1728704969000, // time in seconds you want to extend to receiver: "YOUR_TRON_ADDRESS", // the address that received the resource delegate maxPriceAccepted: 165, // optional. Max price you want to pay to extend resourceType: "ENERGY", // "ENERGY" or "BANDWIDTH". Optional. Default: "ENERGY" }; const res = await fetch(url, { method: "POST", headers: { apikey: "YOUR_API_KEY", "content-type": "application/json", }, body: JSON.stringify(body), }); const response = await res.json(); // response.extendData is used to create the extend request in Step 2 return response; }; ``` {% endtab %} {% tab title="Python" %} ```python import requests url = "https://api.tronsave.io/v2/get-extendable-delegates" headers = { "apikey": "YOUR_API_KEY", "Content-Type": "application/json", } body = { "extendTo": 1728704969000, "receiver": "YOUR_TRON_ADDRESS", "maxPriceAccepted": 165, "resourceType": "ENERGY", } response = requests.post(url, headers=headers, json=body) print(response.json()) ``` {% endtab %} {% tab title="Java" %} ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class GetExtendableDelegates { public static void main(String[] args) throws Exception { String url = "https://api.tronsave.io/v2/get-extendable-delegates"; String body = """ { "extendTo": 1728704969000, "receiver": "YOUR_TRON_ADDRESS", "maxPriceAccepted": 165, "resourceType": "ENERGY" } """; HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .header("apikey", "YOUR_API_KEY") .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } } ``` {% endtab %} {% tab title="Go" %} ```go package main import ( "bytes" "fmt" "io" "net/http" ) func main() { url := "https://api.tronsave.io/v2/get-extendable-delegates" body := []byte(`{ "extendTo": 1728704969000, "receiver": "YOUR_TRON_ADDRESS", "maxPriceAccepted": 165, "resourceType": "ENERGY" }`) req, _ := http.NewRequest("POST", url, bytes.NewBuffer(body)) req.Header.Set("apikey", "YOUR_API_KEY") req.Header.Set("Content-Type", "application/json") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() out, _ := io.ReadAll(resp.Body) fmt.Println(string(out)) } ``` {% endtab %} {% tab title="Rust" %} ```rust use serde_json::json; fn main() -> Result<(), Box> { let url = "https://api.tronsave.io/v2/get-extendable-delegates"; let body = json!({ "extendTo": 1728704969000_i64, "receiver": "YOUR_TRON_ADDRESS", "maxPriceAccepted": 165, "resourceType": "ENERGY" }); let client = reqwest::blocking::Client::new(); let response = client .post(url) .header("apikey", "YOUR_API_KEY") .header("Content-Type", "application/json") .json(&body) .send()?; println!("{}", response.text()?); Ok(()) } ``` {% endtab %} {% endtabs %} {% hint style="info" %} 要与 **TRON Nile（测试网）** 集成，请将基础 URL 替换为 `https://api-dev.tronsave.io`。 {% endhint %} ## 后续步骤 * 将本响应中的 `extendData` 传入 [提交延期请求](/chinese/developers/api-reference/extend-orders/extend-request.md) 以完成延期。 * 在调用 API 之前先设置好 [身份验证](/chinese/developers/authentication.md)。 * 查阅 [能量与带宽](/chinese/concepts/energy-and-bandwidth.md) 和 [订单类型](/chinese/concepts/order-types.md)。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.tronsave.io/chinese/developers/api-reference/extend-orders/get-extendable-delegates.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.