}
```
{% endtab %}
{% tab title="成功响应" %}
```java
{
"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
}
]
}
```
{% endtab %}
{% endtabs %}
### 示例代码
{% tabs %}
{% tab title="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
}
{% endtab %}
{% tab title="cURL" %}
```powershell
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}},
}
'
```
{% endtab %}
{% endtabs %}
## 第 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 步）的响应 |
{% tabs %}
{% tab title="200: OK Success" %}
成功时返回订单 ID 数组。
```json
[,,...]
```
{% endtab %}
{% tab title="401: 未授权 Invalid api key" %}
```json
{
"API_KEY_REQUIRED": "Missing api key in headers",
"INVALID_API_KEY":"api key not correct"
}
```
{% endtab %}
{% tab title="429: 请求过多 Rate limit reached" %}
```json
{
"RATE_LIMIT": "Rate limit reached",
}
```
{% endtab %}
{% endtabs %}
### 示例
{% tabs %}
{% tab title="Body" %}
```json
{
"extend_data":[
{
"delegator": {{some_delegator_address}},
"is_extend": true,
"extra_amount": 0,
"extend_to": {{extend_timestamp_in_millisecs}}
},
...
],
"receiver":{{receiver_address}}
}
```
{% endtab %}
{% tab title="Headers" %}
```json
{
"apikey":
}
```
{% endtab %}
{% tab title="成功响应" %}
```json
["651d2306e55c073f6ca0992e","651d2306e55c073f6ca09923",...]
```
{% endtab %}
{% endtabs %}
### 示例代码
{% tabs %}
{% tab title="Javascript" %}
```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
[]
*/
return response
}
return []
}
```
{% endtab %}
{% tab title="cURL" %}
```powershell
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}}
}
'
```
{% endtab %}
{% endtabs %}
## 后续步骤
* [使用 REST API 购买（v0）](/chinese/developers/legacy-api-v0/api-key.md) —— 旧版购买流程。
* [API 参考](/chinese/developers/api-reference.md) —— 当前推荐使用的 API。
* [身份验证](/chinese/developers/authentication.md) —— 获取并管理您的 API 密钥。
---
# 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/legacy-api-v0/extend.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.