Skip to main content
GET
价格估算

价格估算

返回指定能量数量将实际扣除的金额 —— 租赁费与固定手续费合计,按您的费率计算。 此端点为公开接口 —— 身份验证为可选。 传入您的 API 密钥可获得您的专属价格;不传则返回公开市场价格。
当您需要特定数量的价格时请使用此端点。GET /api/v1/prices 始终按 65,000 单位报价且不接受任何参数,而 POST /api/v1/energy/estimate 仅返回市场价的租赁费,并且会忽略您的密钥。

查询参数

integer
必填
需要估算的能量单位数。范围 60,000 至 5,000,000。
string
默认值:"1h"
租赁时长。能量仅支持 1h

请求头

string
可选。使用有效密钥时,响应会反映您协商的费率和您的手续费。缺失、无效或已吊销的密钥不算错误 —— 您只会得到公开市场价格。

响应

number
本次估算所针对的能量数量
string
租赁时长(1h
string
每 1 单位能量的费率(SUN)。可用它自行计算其他数量:租赁费 = 数量 × price_sun / 1,000,000
string
该数量的租赁费用,不含固定手续费
string
固定手续费,每笔订单收取一次,与数量无关。若您的账户设有专属手续费、折扣或豁免,此处会体现您的实际手续费。
string
将要扣除的金额rental_trx + fixed_fee_trx
string | null
同一金额的美元值。当 TRX/USD 汇率暂时不可用时为 null —— TRX 数值仍然有效。
boolean
应用了您协商的费率时为 true,按公开市场价报价时为 false。请检查该字段:否则遗漏 X-API-Key 请求头的响应看起来与正常响应无异,您会按公开价向客户报价,而实际按您自己的价格扣费。

示例

以下数值仅为示例。能量存在市场价格,且在一天内会波动。
Response

常见数量

不存在套餐目录 —— 60,000 至 5,000,000 之间的任意数量均有效,且固定手续费在任何情况下都只按订单收取一次。向同一收款方进行两笔转账时,合并为一笔 131,000 的订单比拆成两笔 65,000 更划算:手续费只付一次而非两次。

错误

无效或已吊销的 X-API-Key 在此不是错误:仍会按公开市场价返回估算,并将 personal_price 置为 false