Skip to content

交易报价 ​

返回使用相同请求体调用创建交易此刻将扣除的准确总额,且不写入任何内容。与显示公开价目的计算资源成本不同,这是购买实际计价所用的金额。

对于超过最大能量服务的 energy 订单(每单最多 20 000 000),响应还会列出订单将被拆分执行的各个部分。将返回的 amount 作为 expected_amount 传给 /v1/transaction/new,即可按此总额精确扣费 —— 可选,此类订单建议传递。

POST /v1/transaction/quote

请求 ​

请求体与创建交易相同:service、params(以及在此被忽略的 external_id)。校验顺序和错误代码均与其相同。

json
{
  "service": "energy",
  "params": {
    "address": "TRX_ADDRESS",
    "amounts": { "energy": 10000000 },
    "duration": 1
  }
}

响应 ​

字段类型描述
result.servicestring报价的服务
result.amountsobject|null报价的资源数量
result.durationinteger时长(小时)
result.amountstringTRX 总额 —— 包括所有部分,以及所含的地址激活
result.activationboolean总额是否包含地址激活
result.partsarray|null大额能量订单的各个部分:每部分包含 resource_amount 和 amount(TRX);一次性执行的订单为 null
json
{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "service": "energy",
    "amounts": { "energy": 10000000 },
    "duration": 1,
    "amount": "601.200000",
    "activation": false,
    "parts": [
      { "resource_amount": 4000000, "amount": "240.480000" },
      { "resource_amount": 4000000, "amount": "240.480000" },
      { "resource_amount": 2000000, "amount": "120.240000" }
    ]
  }
}

报价只代表当下,并非预留:价格会变动。如果之后订单价格不同,带 expected_amount 的 /v1/transaction/new 会以代码 409 price_moved 拒绝该订单,且不扣除任何费用。

此端点与计算资源成本和估算能量共用同一询价额度。

可能的错误 ​

创建交易在付款前可能出现的错误:1、2、10、11、12、24、25、35、50,询价额度用尽时的 429,TRON 网络未能及时响应地址检查时的 503 temporarily_unavailable(HTTP 503,带 Retry-After 响应头;请稍后重试),以及 500。

Tron Energy API Documentation