交易报价
返回使用相同请求体调用创建交易此刻将扣除的准确总额,且不写入任何内容。与显示公开价目的计算资源成本不同,这是购买实际计价所用的金额。
对于超过最大能量服务的 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.service | string | 报价的服务 |
| result.amounts | object|null | 报价的资源数量 |
| result.duration | integer | 时长(小时) |
| result.amount | string | TRX 总额 —— 包括所有部分,以及所含的地址激活 |
| result.activation | boolean | 总额是否包含地址激活 |
| result.parts | array|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。