POST

Create a quote

/api/v1/energy/quotes

Create a live price quote for delegating Energy or Bandwidth. The quote expires after a short window and becomes binding when you apply it to create an order. If you do not need to lock a price first, use the one-step order instead.

Request body

Field	Type	Required	Description
`amount`	integer	yes	Amount of the resource to delegate — energy or bandwidth (≥ 1).
`duration_minutes`	integer	yes	Rental duration; must be one of the allowed durations.
`target_address`	string	no	TRON address to delegate to. Omit for a price-only estimate.
`product`	string	no	`TRON_ENERGY` (default) or `TRON_BANDWIDTH`.

{
  "amount": 64400,
  "duration_minutes": 60,
  "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
}

Response

{
  "data": {
    "quote_id": "qte_1a2b3c4d5e6f7g8h",
    "product": "TRON_ENERGY",
    "amount": 64400,
    "duration_minutes": 60,
    "customer_price": "2.093",
    "currency": "TRX",
    "expires_at": "2026-09-22T12:01:00.000Z",
    "target_activated": true
  },
  "request_id": "…"
}

Field	Type	Description
`quote_id`	string	Quote id to pass to the apply-quote-orders endpoint.
`customer_price`	string	The price you will pay, in TRX (decimal string, not SUN; 1 TRX = 10^6 SUN).
`expires_at`	string	ISO 8601 time after which the quote cannot be used.
`target_activated`	boolean	Whether the target address was activated on-chain at quote time (advisory).

Errors

INVALID_ADDRESS — target_address is not a valid TRON address.
INVALID_DURATION — duration_minutes is not in the allowed catalog.