POST
/
api
/
tron
/
gas
/
flash
/
open
curl -X POST \
'https://openapi.gasstation.ai/api/tron/gas/flash/open?app_id=49e9c57da66788e5178c8fec2905067b&data=ENCRYPTED_DATA'
{
  "code": 0,
  "msg": "Success",
  "data": {
    "trade_no": "GAS12345678"
  }
}

Energy flash recharge always uses service_charge_type=10000. Do not pass service_charge_type in the request.

  • Only activated TRON addresses that meet the flash recharge rules are supported. Orders are rejected if the purchased quantity is too low or the address’s current energy status does not qualify.
  • Orders are processed asynchronously. A trade_no is returned once the local order is created and the funds are locked. Order progress and settlement details are available in the swap_info field of the record list endpoint.
  • Fund locking: When the order is created, a fee is locked based on the estimated actual delegated energy plus a safety margin, using the energy price and user fee rate at order time. The locked amount may be slightly higher than the fee estimated from energy_num.
  • Settlement: After the energy is reclaimed, the actual fee is calculated from the final billed energy quantity confirmed by the system, using the price and fee-rate snapshot taken at order time. The fee is deducted from the locked amount, and the remainder is automatically unlocked back to the available balance.
  • Order failure: The entire locked amount is unlocked back to the available balance and no fee is charged.

Request Parameters

request_id
string
required

Unique business request ID. It cannot be reused under the same account.

receive_address
string
required

Address receiving the energy. Only one address is supported.

energy_num
integer
required

Energy quantity purchased by the user. Final billing is based on the actual billed energy quantity confirmed by the system after reclaim, which may differ slightly from the purchased quantity. See swap_info in the record list endpoint for settlement details.

Response Parameters

curl -X POST \
'https://openapi.gasstation.ai/api/tron/gas/flash/open?app_id=49e9c57da66788e5178c8fec2905067b&data=ENCRYPTED_DATA'
{
  "code": 0,
  "msg": "Success",
  "data": {
    "trade_no": "GAS12345678"
  }
}