'/%3e%3cdefs%3e%3cpattern%20id='pattern0_2104_4598'%20patternContentUnits='objectBoundingBox'%20width='1'%20height='1'%3e%3cuse%20xlink:href='%23image0_2104_4598'%20transform='matrix(0.00376176%200%200%200.0172414%20-0.00219436%200)'/%3e%3c/pattern%3e%3cimage%20id='image0_2104_4598'%20width='267'%20height='58'%20preserveAspectRatio='none'%20xlink:href='data:image/png;base64,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'/%3e%3c/defs%3e%3c/svg%3e)
Overview
Gas stations are pre-funded wallets that sponsor transaction fees for other wallets in the organization. On Tron, gas stations support TRX staking and resource delegation for energy and bandwidth efficiency.
Create Gas Station
Use Case
Provisions a new gas station for a chain/network with an optional auto-refill source.
Request Body
Display name for the gas station (2-100 characters). Shown in dashboards and audit logs.
Blockchain the gas station sponsors fees on (e.g., `ethereum`, `tron`).
Network within the chain (e.g., `mainnet`, `sepolia`).
Low-balance alert threshold (numeric, > 0) in the native asset. Crossing it flips `health_status` from `healthy` to `low`.
Turn on automatic top-ups from `refill_from_wallet_id` whenever the balance falls below `threshold`.
Amount of native asset (numeric, > 0) to move on each auto-refill.
Source treasury wallet that funds auto-refills. Required when `auto_refill_enabled = true`.
How Bitnob prices fees when sponsoring transactions from this station (e.g., `medium`, `aggressive`). Leave empty for the default strategy.
Create Gas Station Response
Unique identifier for the gas station. Use it for refills, configuration changes, and Tron staking endpoints.
Display name as supplied on creation.
Blockchain the gas station operates on.
Network within the chain.
Native asset symbol used for sponsorship (e.g., `ETH`, `TRX`).
On-chain address the gas station signs from when topping up customer wallets.
Current native-asset balance held by the station.
USD equivalent of `balance` at the latest exchange rate.
Configured low-balance threshold. Once balance dips below this, `health_status` flips to `low`.
Computed `(balance / threshold) * 100`. Useful as a single number for dashboards.
`healthy` when balance ≥ threshold; `low` when it's dropped beneath. Drive alerts off this.
Whether auto-refill is currently active.
How much native asset auto-refill will move on each top-up.
Source treasury wallet that funds auto-refills.
Gas pricing strategy this station uses when sponsoring transactions.
`active` (sponsoring) or `inactive` (paused). `active` immediately after creation.
When the gas station was created.
Timestamp of the most recent configuration update.
Total energy units available from TRX staked for energy. Tron only.
Energy consumed in the current cycle. Tron only.
Energy still available to spend in the current cycle. Tron only.
Total bandwidth points available from TRX staked for bandwidth. Tron only.
Bandwidth consumed in the current cycle. Tron only.
Bandwidth still available to spend in the current cycle. Tron only.
TRX currently staked for energy. Tron only.
TRX currently staked for bandwidth. Tron only.
List Gas Stations
Use Case
Lists gas stations in the organization.
Query Parameters
Page size. Default 20, max 100.
Number of items to skip. Default 0. Pair with `limit` for cursor-style paging.
Filter by blockchain (e.g., `ethereum`, `tron`). Useful when you run gas stations on several chains.
`active` (sponsoring) or `inactive` (paused).
List Gas Stations Response
Each entry in data[] uses the same GasStationResponse object as Create Gas Station Response. Refer there for the per-field explanations. The meta envelope below carries pagination state (total, limit, offset, has_more).
Get Gas Station
Use Case
Retrieves a single gas station by ID.
Get Gas Station Response
data is the same GasStationResponse object returned by Create Gas Station Response. Refer there for the per-field explanations.
Update Gas Station
Use Case
Updates the gas station's configuration (name, threshold, auto-refill, gas strategy, status).
Request Body
Updated display name (2-100 characters).
New low-balance alert threshold (numeric, > 0).
Turn auto-refill on or off.
Updated per-refill amount (numeric, > 0).
Swap the source treasury wallet that funds auto-refills.
Updated gas pricing strategy used when sponsoring transactions.
Set to `active` to resume sponsoring; `inactive` to pause.
Update Gas Station Response
data is the same GasStationResponse object returned by Create Gas Station Response. Refer there for the per-field explanations. The fields you supplied in the request body are reflected back along with a fresh updated_at timestamp.
Refill Gas Station
Use Case
Transfers native tokens from a source wallet to the gas station.
Request Body
Wallet to transfer from.
Amount (numeric, > 0).
1-64 characters.
Sponsor and Broadcast
Use Case
Sponsors and broadcasts an externally signed Tron transaction through the selected gas station. The station covers the TRX energy/bandwidth fee while the caller supplies the pre-signed payload.
Request Body
Sender's Tron address (e.g. `TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE`).
Recipient's Tron address.
Asset symbol to transfer (e.g. `USDT`).
Transfer amount in the asset's smallest unit, as a string to preserve precision.
Network identifier (e.g. `mainnet`).
Pre-signed transaction hex produced client-side.
Transaction hash that matches `signed_tx`.
Fee tier: `low`, `medium`, or `high`. Defaults to the station's strategy when omitted.
Sponsor and Broadcast Response
Resource type identifier.
Operation mode used for the sponsorship.
Current broadcast status.
On-chain transaction hash for the broadcast transaction.
Unique identifier for this sponsorship transaction.
Root sponsorship transaction identifier — groups related sponsorships.
Gas station that paid the fee.
TRX amount the gas station spent sponsoring this transaction.
`true` when the node accepted the broadcast.