> 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/buy-resources/signed-tx/estimate-trx.md). # 预估 TRX 获取购买资源所需 TRX 的预估值。在签名交易流程中首先调用此端点，以了解 `unitPrice`、需要支付的 `estimateTrx`，以及实际可用于成交订单的资源数量。 **`POST`** **`https://api.tronsave.io/v2/estimate-buy-resource`** {% hint style="info" %} **速率限制：** 每 1 秒 15 个请求。 {% endhint %} {% hint style="info" %} 测试网基础 URL：`https://api-dev.tronsave.io`。参见[环境](/chinese/developers/environments.md)。 {% endhint %} ## 请求头 | Header | 值 | 是否必填 | | -------------- | ------------------ | ---- | | `Content-Type` | `application/json` | 是 | ## 请求参数
字段类型说明
resourceAmount*Number资源数量。
unitPriceString, Number

"FAST"、"MEDIUM"、"SLOW" 或数字：


-"FAST"：如果市场可成交比例 = 100%，则 FAST = MEDIUM。如果市场可成交比例 < 100%，则 FAST = MEDIUM + 10。如果市场可成交比例 = 0%，则 FAST = SLOW + 20。

-"MEDIUM"：在该订单达到市场最大成交量时的最低价格。如果市场可成交比例 = 0%，则 MEDIUM = SLOW + 10。

-"SLOW"：该订单可设置的最低价格。

-如果价格为数字，价格单位等于 SUN

durationSecNumber所购资源的时长，时间单位为秒。默认 3 天
requesterString请求方地址。
receiverString资源接收地址。
resourceTypeString"ENERGY" 或 "BANDWIDTH"，默认值："ENERGY"
optionsObject可选
options.allowPartialFillBoolean是否允许订单部分成交
options.minResourceDelegateRequiredAmountNumber单个供应商代理（委托）的最小资源数量。
## 请求体示例 ```json { "resourceType": "ENERGY", "receiver": "TFwUFWr3QV376677Z8VWXxGUAMF123456", "durationSec": 259200, "resourceAmount": 32000, "unitPrice": "MEDIUM", "options": { "allowPartialFill": true, "minResourceDelegateRequiredAmount": 32000 } } ``` ## 响应 ### 成功 ```json { "error": false, "message": "Success", "data": { "unitPrice": 64, "durationSec": 259200, "estimateTrx": 6144000, "availableResource": 32000 } } ``` `estimateTrx` 的值以 SUN 返回（1 TRX = 1,000,000 SUN）。`unitPrice` 是以 SUN 计的每单位价格，`availableResource` 是市场可成交的请求资源数量。 ### 错误 由于此端点通过签名交易（而非 API 密钥）进行身份验证，因此不会因缺少凭据而返回 `401`。最常见的错误是当必填字段缺失或无效时的模式校验错误。`message` 会指明出错的字段。 **400 Bad Request — 校验错误（缺少必填字段 `resourceAmount`）：** ```json { "statusCode": 400, "code": "FST_ERR_VALIDATION", "error": "Bad Request", "message": "body must have required property 'resourceAmount'" } ``` **404 Not Found — 路由/路径错误：** ```json { "message": "Route POST:/v2/... not found", "error": "Not Found", "statusCode": 404 } ``` ## 请求示例 {% tabs %} {% tab title="cURL" %} ```bash curl -X POST https://api.tronsave.io/v2/estimate-buy-resource \ -H "Content-Type: application/json" \ -d '{ "resourceType": "ENERGY", "receiver": "YOUR_TRON_ADDRESS", "durationSec": 259200, "resourceAmount": 32000, "unitPrice": "MEDIUM", "options": { "allowPartialFill": true } }' ``` {% endtab %} {% tab title="JavaScript" %} ```javascript const TRONSAVE_API_URL = "https://api.tronsave.io"; const getEstimate = async (requesterAddress, receiverAddress, resourceAmount, durationSec) => { const url = `${TRONSAVE_API_URL}/v2/estimate-buy-resource`; const body = { resourceAmount, unitPrice: "MEDIUM", resourceType: "ENERGY", durationSec, requester: requesterAddress, receiver: receiverAddress, options: { allowPartialFill: true, }, }; const res = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify(body), }); return res.json(); }; // getEstimate("YOUR_TRON_ADDRESS", "YOUR_TRON_ADDRESS", 32000, 259200); ``` {% endtab %} {% tab title="Python" %} ```python import requests TRONSAVE_API_URL = "https://api.tronsave.io" def get_estimate(requester, receiver, resource_amount, duration_sec): url = f"{TRONSAVE_API_URL}/v2/estimate-buy-resource" body = { "resourceAmount": resource_amount, "unitPrice": "MEDIUM", "resourceType": "ENERGY", "durationSec": duration_sec, "requester": requester, "receiver": receiver, "options": { "allowPartialFill": True, }, } response = requests.post(url, json=body) return response.json() # get_estimate("YOUR_TRON_ADDRESS", "YOUR_TRON_ADDRESS", 32000, 259200) ``` {% 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 EstimateTrx { static final String TRONSAVE_API_URL = "https://api.tronsave.io"; public static void main(String[] args) throws Exception { String body = """ { "resourceType": "ENERGY", "receiver": "YOUR_TRON_ADDRESS", "durationSec": 259200, "resourceAmount": 32000, "unitPrice": "MEDIUM", "options": { "allowPartialFill": true } } """; HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(TRONSAVE_API_URL + "/v2/estimate-buy-resource")) .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" ) const tronsaveAPIURL = "https://api.tronsave.io" func main() { body := []byte(`{ "resourceType": "ENERGY", "receiver": "YOUR_TRON_ADDRESS", "durationSec": 259200, "resourceAmount": 32000, "unitPrice": "MEDIUM", "options": { "allowPartialFill": true } }`) req, err := http.NewRequest("POST", tronsaveAPIURL+"/v2/estimate-buy-resource", bytes.NewBuffer(body)) if err != nil { panic(err) } 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 reqwest::blocking::Client; use serde_json::json; const TRONSAVE_API_URL: &str = "https://api.tronsave.io"; fn main() -> Result<(), Box> { let body = json!({ "resourceType": "ENERGY", "receiver": "YOUR_TRON_ADDRESS", "durationSec": 259200, "resourceAmount": 32000, "unitPrice": "MEDIUM", "options": { "allowPartialFill": true } }); let client = Client::new(); let response = client .post(format!("{}/v2/estimate-buy-resource", TRONSAVE_API_URL)) .header("Content-Type", "application/json") .json(&body) .send()?; println!("{}", response.text()?); Ok(()) } ``` {% endtab %} {% endtabs %} ## 后续步骤 * [获取签名交易](/chinese/developers/api-reference/buy-resources/signed-tx/get-signed-transaction.md) * [创建订单](/chinese/developers/api-reference/buy-resources/signed-tx/create-order.md) * 返回[使用签名交易购买](/chinese/developers/api-reference/buy-resources/signed-tx.md)