Get Estimate

GET 
/estimate

Returns TRONAgg's current price for resource_amount units of Energy (default) or Bandwidth delivered for 1 hour — what POST /buy would charge your balance right now (your VIP price if you have one; VIP pricing applies to Energy).

Parameters:

• resource_amount — amount of the resource to rent (in resource units, not TRX)
• resource_type (optional) — ENERGY (default) or BANDWIDTH
• receiver_address (optional) — the address that will receive the resource. Pass it to include the one-time account-activation fee when the address is not yet activated on TRON. Without it the quote leaves that fee out, while POST /buy still charges it.

The response includes the unit price in SUN, the total cost, any activation fee, and the selected resource's order-size limits (min_amount / max_amount). Use it to preview costs before committing to a purchase.

Request

Responses

200

Successful Response

400

unsupported_resource or invalid_duration — only Energy or Bandwidth for a 1-hour duration is offered.

401

The X-API-Key header is missing, invalid or revoked. detail is a plain string: API key required, Invalid API key or User not found.

403

The account is blocked (plain-string detail: Account is blocked), or ip_not_allowed — the request's source IP is outside this key's IP allowlist.

422

Request validation failed (e.g. resource_amount missing or not above 0) — detail is an array of field errors.

429

Rate limit exceeded — more than 1,000 requests per minute for your account (shared by all of its API keys and workspace sessions). detail is a plain string; wait the number of seconds in Retry-After, then retry.

Response Headers

Retry-After

Seconds until the rate-limit window resets.

503

service_unavailable — purchasing the requested resource is temporarily unavailable.