核心 API
价格估算
指定能量数量的最终价格,已包含固定手续费
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,000string
该数量的租赁费用,不含固定手续费
string
固定手续费,每笔订单收取一次,与数量无关。若您的账户设有专属手续费、折扣或豁免,此处会体现您的实际手续费。
string
将要扣除的金额:
rental_trx + fixed_fee_trxstring | 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。