'/%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 stationPOST/gasstations
- List gas stationsGET/gasstations
- Get gas stationGET/gasstations/:id
- Configure gas stationPUT/gasstations/:id
- Delete gas stationDELETE/gasstations/:id
- Refill gas stationPOST/gasstations/:id/refill
- StatsGET/gasstations/stats
- Refill historyGET/gasstations/refill-history
- Usage historyGET/gasstations/usage-history
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.
Configure 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.
Configure 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.
Delete Gas Station
Use Case
Removes a gas station.
Response: 204 No Content — empty body.
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.
Stats, Refill & Usage History
Use Case
Aggregate stats across all gas stations, plus paginated refill and usage history. The two history endpoints share the same query parameters.
Stats Response
Sum of every gas station's native balance, in their own unit. Mixed-asset orgs should treat this as informational.
USD-normalised total balance across all stations. Use this for a single dashboard number.
Count of gas stations with `status: "active"`.
Number of stations currently below their `threshold` (i.e., `health_status: "low"`). Drive ops alerts off this.
Number of sponsored / refill transactions executed today across all stations.
History Query Parameters
Used by both GET /gasstations/refill-history and GET /gasstations/usage-history.
Page size. Default 20, max 100.
Number of items to skip. Default 0.
Narrow to a single gas station.
Filter by blockchain (e.g., `ethereum`, `tron`).
Filter by transaction status (e.g., `completed`, `failed`).
Custom range start. Pair with `date_to` to scope to a precise window.
Custom range end.
Preset window: `today`, `week`, `month`, or `all`. Quicker than supplying date bounds for common ranges.