获取报价
GET/estimate
返回 TRONAgg 对交付 1 小时的 resource_amount 单位能量(默认)或带宽的当前价格——即此刻 POST /buy 会从你的余额扣取的金额(如果你有 VIP 价格,则按 VIP 价格计算;VIP 价格适用于能量)。
参数:
resource_amount——要租用的资源数量(以资源单位计,不是 TRX)resource_type(可选)——ENERGY(默认)或BANDWIDTHreceiver_address(可选)——将接收该资源的地址。传入它,报价才会在该地址尚未在 TRON 上激活时包含一次性账户激活费。不传时报价不含这笔费用,但POST /buy仍会收取。
响应包含以 SUN 计的单价、总费用、激活费(如有)以及所选资源的订单数量限制(min_amount / max_amount)。在确认购买之前,用它预览费用。
请求
Responses
- 200
- 400
- 401
- 403
- 422
- 429
- 503
成功响应
unsupported_resource 或 invalid_duration——仅提供时长为 1 小时的能量或带宽。
X-API-Key 请求头缺失、无效或已撤销。detail 为纯字符串:API key required、Invalid API key 或 User not found。
账户已被封禁(纯字符串 detail:Account is blocked),或 ip_not_allowed——请求的来源 IP 不在该密钥的 IP 白名单内。
请求校验失败(例如缺少 resource_amount 或其不大于 0)——detail 为字段错误数组。
Rate limit exceeded——你的账户每分钟请求超过 1,000 次(由该账户的所有 API 密钥与工作台会话共用)。detail 为纯字符串;等待 Retry-After 给出的秒数后再重试。
Response Headers
Retry-After
距离限流窗口重置的秒数。
service_unavailable——所请求资源的购买暂时不可用。