Skip to main content

GET Config

/api/v1/config

This call returns the complete account configuration, including current balances, resource pricing, and coupon summary, in a single request.

tip

This endpoint requires the ADMIN (spender) API key.

info

Balances are provided with 6 decimal places, consistent with their on-chain representation. Resource prices are provided in sun/unit.

Response contains the following data:

  1. activation_price: account activation fee (in sun)
  2. active_coupons_count: number of currently active (unspent, unexpired) coupons
  3. balance_on_coupons_rtrx: total TFN (former RTRX) locked on active coupons
  4. balance_rtrx: current TFN (former RTRX) balance
  5. balance_rusdt: current TFU (former RUSDT) balance
  6. bandwidth_price_per_unit: bandwidth price per unit (in sun)
  7. energy_price_per_unit: energy price per unit (in sun)
  8. payment_address: TRON deposit address for topping up the account
  9. notice (optional): an array of plain-text notification strings. Only present when there are active notices for the account — for example, when the account email has not been verified yet. Absent from the response when there are no notices.

Example of response:

{
"activation_price": 1100000,
"active_coupons_count": 3,
"balance_on_coupons_rtrx": 23750000,
"balance_rtrx": 184206735,
"balance_rusdt": 52847190,
"bandwidth_price_per_unit": 1000,
"energy_price_per_unit": 38,
"payment_address": "TXr4B8dNfEn7K2pGLkvsq9WBcKR1F8mHa6",
"notice": [
"Your account email address has not been verified. Please check your inbox for a confirmation email and follow the link to verify your email address."
]
}