Skip to content
TronGasAi Docs

Create an auto-renewal rule (energy)

POST
/api/v1/automations/renewal
curl --request POST \
  --url https://trongas.ai/api/v1/automations/renewal \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <X-Api-Key>' \
  --data '{ "targetAddress": "example", "volume": 1, "autoResume": false }'

Required API-key scope: trade

Renew a fixed volume of energy on an address once a day, regardless of how much is left — unlike auto-refill, which reacts to a threshold.

Each renewal is charged to your TRX balance at your price. Creating the rule requires enough balance for at least one renewal, otherwise 402 wallet.insufficient_balance. If the balance can no longer cover the next one the rule is paused; set autoResume to have it come back by itself once you top up.

Energy only.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
object
targetAddress
required
string
volume
required
integer | string format: int64
/^-?(?:0|[1-9]\d*)$/
autoResume
boolean

Responses

Section titled “Responses”

200

Section titled “200”

OK

object
id
required
string format: uuid
type
required
string
resource
required
string
targetAddress
required
string
minimal
required
null | integer | string format: int64
/^-?(?:0|[1-9]\d*)$/
volume
required
null | integer | string format: int64
/^-?(?:0|[1-9]\d*)$/
duration
required
null | string
spentTrx
required
string
status
required
string
pauseReason
required
null | string
autoResume
required
boolean
feeSaverOrderId
required
null | integer | string format: int64
/^-?(?:0|[1-9]\d*)$/
createdAt
required
string format: date-time
updatedAt
required
string format: date-time

402

Section titled “402”

Payment Required

object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string