> 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 密钥。 --- # 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/buy-resources/api-key/estimate-trx.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.