Configure the Fireblocks Gas Station — auto-fuel logic that tops up native-asset balances in vault accounts so ERC-20 / SPL / contract-call transactions don't fail for lack of gas. Per-asset thresholds are workspace-configurable.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/fireblocks-gas-station-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Fireblocks Blockchains and Assets Approval Requests Gas Station API
description: 'Fireblocks provides a suite of applications to manage digital asset operations and a complete development platform to build your business on the blockchain.
- Visit our website for more information: [Fireblocks Website](https://fireblocks.com)
- Visit our developer docs: [Fireblocks DevPortal](https://developers.fireblocks.com)
'
version: 1.8.0
contact:
email: developers@fireblocks.com
servers:
- url: https://api.fireblocks.io/v1
description: Fireblocks Production Environment Base URL
- url: https://sandbox-api.fireblocks.io/v1
description: Fireblocks Sandbox Environment Base URL
security: []
tags:
- name: Gas Station
paths:
/gas_station:
get:
summary: Get gas station settings
description: 'Returns gas station settings and ETH balance.
</br>Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor.'
tags:
- Gas Station
x-readme:
code-samples:
- language: javascript
code: const gasStationInfo = await fireblocks.gasStationInfo();
name: Fireblocks SDK Javascript example
- language: typescript
code: 'const response: Promise<FireblocksResponse<GasStationPropertiesResponse>> = fireblocks.gasStations.getGasStationInfo();'
name: Fireblocks SDK TypeScript example
- language: java
code: CompletableFuture<ApiResponse<GasStationPropertiesResponse>> response = fireblocks.gasStations().getGasStationInfo();
name: Fireblocks SDK Java example
- language: python
code: response = fireblocks.gas_stations.get_gas_station_info();
name: Fireblocks SDK Python example
responses:
'200':
description: Gas Station properties
headers:
X-Request-ID:
$ref: '#/components/headers/X-Request-ID'
content:
application/json:
schema:
$ref: '#/components/schemas/GasStationPropertiesResponse'
default:
$ref: '#/components/responses/Error'
operationId: getGasStationInfo
x-codeSamples:
- lang: TypeScript
source: 'const response: Promise<FireblocksResponse<GasStationPropertiesResponse>> = fireblocks.gasStations.getGasStationInfo();'
- lang: Java
source: CompletableFuture<ApiResponse<GasStationPropertiesResponse>> response = fireblocks.gasStations().getGasStationInfo();
- lang: Python
source: response = fireblocks.gas_stations.get_gas_station_info();
/gas_station/{assetId}:
get:
summary: Get gas station settings by asset
description: 'Returns gas station settings and balances for a requested asset.
</br>Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor.'
tags:
- Gas Station
x-readme:
code-samples:
- language: javascript
code: const gasStationInfo = await fireblocks.gasStationInfo(assetId);
name: Fireblocks SDK Javascript example
- language: typescript
code: 'const response: Promise<FireblocksResponse<GasStationPropertiesResponse>> = fireblocks.gasStations.getGasStationByAssetId(gasStationsApiGetGasStationByAssetIdRequest);'
name: Fireblocks SDK TypeScript example
- language: java
code: CompletableFuture<ApiResponse<GasStationPropertiesResponse>> response = fireblocks.gasStations().getGasStationByAssetId(assetId);
name: Fireblocks SDK Java example
- language: python
code: response = fireblocks.gas_stations.get_gas_station_by_asset_id(asset_id);
name: Fireblocks SDK Python example
parameters:
- in: path
required: true
name: assetId
description: The ID of the asset
schema:
type: string
x-fb-entity: asset
example: ETH
responses:
'200':
description: Gas Station properties
headers:
X-Request-ID:
$ref: '#/components/headers/X-Request-ID'
content:
application/json:
schema:
$ref: '#/components/schemas/GasStationPropertiesResponse'
default:
$ref: '#/components/responses/Error'
operationId: getGasStationByAssetId
x-codeSamples:
- lang: TypeScript
source: 'const response: Promise<FireblocksResponse<GasStationPropertiesResponse>> = fireblocks.gasStations.getGasStationByAssetId(gasStationsApiGetGasStationByAssetIdRequest);'
- lang: Java
source: CompletableFuture<ApiResponse<GasStationPropertiesResponse>> response = fireblocks.gasStations().getGasStationByAssetId(assetId);
- lang: Python
source: response = fireblocks.gas_stations.get_gas_station_by_asset_id(asset_id);
/gas_station/configuration:
put:
summary: Edit gas station settings
description: 'Configures gas station settings for ETH.
Learn more about the Fireblocks Gas Station in the following [guide](https://developers.fireblocks.com/docs/work-with-gas-station).
</br>Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor.'
tags:
- Gas Station
x-readme:
code-samples:
- language: javascript
code: const gasStation = await fireblocks.setGasStationConfiguration(gasThreshold, gasCap, maxGasPrice)
name: Fireblocks SDK Javascript example
- language: typescript
code: 'const response: Promise<FireblocksResponse<EditGasStationConfigurationResponse>> = fireblocks.gasStations.updateGasStationConfiguration(gasStationsApiUpdateGasStationConfigurationRequest);'
name: Fireblocks SDK TypeScript example
- language: java
code: CompletableFuture<ApiResponse<EditGasStationConfigurationResponse>> response = fireblocks.gasStations().updateGasStationConfiguration(gasStationConfiguration, idempotencyKey);
name: Fireblocks SDK Java example
- language: python
code: response = fireblocks.gas_stations.update_gas_station_configuration(gas_station_configuration, idempotency_key);
name: Fireblocks SDK Python example
parameters:
- $ref: '#/components/parameters/X-Idempotency-Key'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GasStationConfiguration'
responses:
'201':
description: OK
headers:
X-Request-ID:
$ref: '#/components/headers/X-Request-ID'
content:
application/json:
schema:
$ref: '#/components/schemas/EditGasStationConfigurationResponse'
default:
$ref: '#/components/responses/Error'
operationId: updateGasStationConfiguration
x-codeSamples:
- lang: TypeScript
source: 'const response: Promise<FireblocksResponse<EditGasStationConfigurationResponse>> = fireblocks.gasStations.updateGasStationConfiguration(gasStationsApiUpdateGasStationConfigurationRequest);'
- lang: Java
source: CompletableFuture<ApiResponse<EditGasStationConfigurationResponse>> response = fireblocks.gasStations().updateGasStationConfiguration(gasStationConfiguration, idempotencyKey);
- lang: Python
source: response = fireblocks.gas_stations.update_gas_station_configuration(gas_station_configuration, idempotency_key);
/gas_station/configuration/{assetId}:
put:
operationId: updateGasStationConfigurationByAssetId
summary: Edit gas station settings for an asset
description: 'Configures gas station settings for a requested asset.
Learn more about the Fireblocks Gas Station in the following [guide](https://developers.fireblocks.com/docs/work-with-gas-station).
</br>Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor.'
tags:
- Gas Station
parameters:
- in: path
required: true
name: assetId
description: The ID of the asset
schema:
type: string
x-fb-entity: asset
example: ETH
- $ref: '#/components/parameters/X-Idempotency-Key'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GasStationConfiguration'
responses:
'201':
description: OK
headers:
X-Request-ID:
$ref: '#/components/headers/X-Request-ID'
content:
application/json:
schema:
$ref: '#/components/schemas/EditGasStationConfigurationResponse'
default:
$ref: '#/components/responses/Error'
x-readme:
code-samples:
- language: typescript
code: 'const response: Promise<FireblocksResponse<EditGasStationConfigurationResponse>> = fireblocks.gasStations.updateGasStationConfigurationByAssetId(gasStationsApiUpdateGasStationConfigurationByAssetIdRequest);'
name: Fireblocks SDK TypeScript example
- language: java
code: CompletableFuture<ApiResponse<EditGasStationConfigurationResponse>> response = fireblocks.gasStations().updateGasStationConfigurationByAssetId(gasStationConfiguration, assetId, idempotencyKey);
name: Fireblocks SDK Java example
- language: python
code: response = fireblocks.gas_stations.update_gas_station_configuration_by_asset_id(gas_station_configuration, asset_id, idempotency_key);
name: Fireblocks SDK Python example
x-codeSamples:
- lang: TypeScript
source: 'const response: Promise<FireblocksResponse<EditGasStationConfigurationResponse>> = fireblocks.gasStations.updateGasStationConfigurationByAssetId(gasStationsApiUpdateGasStationConfigurationByAssetIdRequest);'
- lang: Java
source: CompletableFuture<ApiResponse<EditGasStationConfigurationResponse>> response = fireblocks.gasStations().updateGasStationConfigurationByAssetId(gasStationConfiguration, assetId, idempotencyKey);
- lang: Python
source: response = fireblocks.gas_stations.update_gas_station_configuration_by_asset_id(gas_station_configuration, asset_id, idempotency_key);
components:
schemas:
GasStationPropertiesResponse:
type: object
properties:
balance:
type: object
configuration:
$ref: '#/components/schemas/GasStationConfigurationResponse'
GasStationConfigurationResponse:
type: object
properties:
gasThreshold:
description: The Gas Station will initiate a fueling transaction when the vault account's balance falls below the gasThreshold value
type: string
default: '0.005'
example: '0.005'
gasCap:
description: The Gas Station will top up the vault account with gas until the balance reaches the gasCap value
example: '0.01'
default: '0.01'
type: string
maxGasPrice:
description: Maximum gas price for the fueling transaction (in gwei)
example: '20'
default: null
type:
- string
- 'null'
EditGasStationConfigurationResponse:
type: object
properties:
success:
type: boolean
description: Indicates whether editing the gas station configuration was successful
required:
- success
GasStationConfiguration:
type: object
properties:
gasThreshold:
description: The Gas Station will initiate a fueling transaction when the vault account's balance falls below the gasThreshold value
type: string
default: '0.005'
example: '0.005'
gasCap:
description: The Gas Station will top up the vault account with gas until the balance reaches the gasCap value
example: '0.01'
default: '0.01'
type: string
maxGasPrice:
description: Maximum gas price for the fueling transaction (in gwei)
example: '20'
default: null
type:
- string
- 'null'
parameters:
X-Idempotency-Key:
name: Idempotency-Key
in: header
description: A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.
required: false
schema:
type: string
example: some-unique-id
responses:
Error:
description: Error Response
headers:
X-Request-ID:
$ref: '#/components/headers/X-Request-ID'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorSchema'
securitySchemes:
bearerTokenAuth:
type: http
scheme: bearer
bearerFormat: JWT
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key