预估 TRX

在创建签名交易订单之前,预估购买指定数量和租赁时长的能量或带宽所需的 TRX。

获取购买资源所需 TRX 的预估值。在签名交易流程中首先调用此端点,以了解 unitPrice、需要支付的 estimateTrx,以及实际可用于成交订单的资源数量。

POST https://api.tronsave.io/v2/estimate-buy-resource

速率限制: 每 1 秒 15 个请求。

测试网基础 URL:https://api-dev.tronsave.io。参见环境

请求头

Header
是否必填

Content-Type

application/json

请求参数

字段
类型
说明

resourceAmount*

Number

资源数量。

unitPrice

String, Number

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

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

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

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

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

durationSec

Number

所购资源的时长,时间单位为秒。默认 3 天

requester

String

请求方地址。

receiver

String

资源接收地址。

resourceType

String

"ENERGY" 或 "BANDWIDTH",默认值:"ENERGY"

options

Object

可选

options.allowPartialFill

Boolean

是否允许订单部分成交

options.minResourceDelegateRequiredAmount

Number

单个供应商代理(委托)的最小资源数量。

请求体示例

响应

成功

estimateTrx 的值以 SUN 返回(1 TRX = 1,000,000 SUN)。unitPrice 是以 SUN 计的每单位价格,availableResource 是市场可成交的请求资源数量。

错误

由于此端点通过签名交易(而非 API 密钥)进行身份验证,因此不会因缺少凭据而返回 401。最常见的错误是当必填字段缺失或无效时的模式校验错误。message 会指明出错的字段。

400 Bad Request — 校验错误(缺少必填字段 resourceAmount):

404 Not Found — 路由/路径错误:

请求示例

后续步骤

Last updated