> ## Documentation Index
> Fetch the complete documentation index at: https://gasdocs-en.gasstation.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Energy / Bandwidth Flash Recharge

> Create a TRON energy or bandwidth flash recharge order

Flash recharge always uses `service_charge_type=10000`. Do not pass `service_charge_type` in the request.

> [!NOTE]
>
> * 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 resource 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](https://gasdocs-en.gasstation.ai/api-references/gas-apis/apis/gas-record-list.md) endpoint.
> * **Fund locking**: When the order is created, a fee is locked based on the estimated actual delegated resource quantity plus a safety margin, using the resource price and user fee rate at order time. The locked amount may be slightly higher than the fee estimated from the purchased quantity.
> * **Settlement**: After the resource is reclaimed, the actual fee is calculated from the final billed resource 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 resource. Only one address is supported.

**resource\_type** `integer` (default: 1)

`1`: energy; `2`: bandwidth. Defaults to `1` when omitted. `0` is not supported.

**energy\_num** `integer`

Energy quantity. Required and positive for energy recharge; omit or pass `0` for bandwidth recharge. Final billing uses the quantity confirmed after reclaim.

**net\_num** `integer`

Bandwidth quantity. Required and positive for bandwidth recharge; omit or pass `0` for energy recharge. Nonzero quantities for both resources are not allowed in one order.

#### Bandwidth Request Parameters Before Encryption

```json theme={null}
{
  "request_id": "flash_net_001",
  "receive_address": "YOUR_TRON_ADDRESS",
  "resource_type": 2,
  "net_num": 1000
}
```

#### Response Parameters

**object**

**trade\_no** `string`

Gas Station order ID.

```curl cURL theme={null}
curl -X POST \
'https://openapi.gasstation.ai/api/tron/gas/flash/open?app_id=49e9c57da66788e5178c8fec2905067b&data=ENCRYPTED_DATA'
```

```json theme={null}
{
  "code": 0,
  "msg": "Success",
  "data": {
    "trade_no": "GAS12345678"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.