> 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/api-key/estimate-trx.md). # 预估 TRX 使用此端点可以在下单前计算一笔订单的成本。传入资源数量、租赁时长以及单价（或速度档位），TronSave 会返回解析后的单价、预估的 TRX，以及当前可用的请求资源数量。 ## 端点 **`POST`** **`https://api.tronsave.io/v2/order-book/estimate-buy-resource`** {% hint style="info" %} **速率限制：** 每 1 秒 15 次请求。 {% 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）。 ### 错误 {% tabs %} {% tab title="401 缺少 API 密钥" %} 当缺少 `apikey` 请求头时返回。 ```json { "error": true, "message": "TSAS:106 API_KEY_REQUIRED", "data": null } ``` {% endtab %} {% tab title="401 无效的 API 密钥" %} 当提供了 `apikey` 请求头但无效时返回。 ```json { "error": true, "message": "TSAS:107 INVALID_API_KEY", "data": null } ``` {% endtab %} {% tab title="400 校验错误" %} 当必填字段缺失或无效时返回。`message` 会指明出错的字段。 ```json { "statusCode": 400, "code": "FST_ERR_VALIDATION", "error": "Bad Request", "message": "body must have required property 'resourceAmount'" } ``` {% endtab %} {% endtabs %} ## 请求示例 {% 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/api-key/create-order.md) — 在获得预估后下单。 * [获取订单簿](/chinese/developers/api-reference/buy-resources/api-key/get-order-book.md) — 查看当前价格与可用量。 * [身份验证](/chinese/developers/authentication.md) — 如何在每次请求中传递你的 API 密钥。