Gas Tank Balance

curl --request GET \
     --url https://api.finrock.io/dac/v1/gas-tank-bal/ETH \
     --header 'Authorization: Token {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: {{api_key}}'

{
  "balance": 0.00590765,
  "balance_in_usd": 16.0348980890000000
}

GET

dac

gas-tank-bal

{asset}

curl --request GET \
     --url https://api.finrock.io/dac/v1/gas-tank-bal/ETH \
     --header 'Authorization: Token {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: {{api_key}}'

{
  "balance": 0.00590765,
  "balance_in_usd": 16.0348980890000000
}

MCP scope: dac.read Each blockchain network supported by Finrock uses native tokens (e.g., ETH on Ethereum, BNB on BNB Chain) to pay on-chain transaction fees. This endpoint returns the real-time balance of the gas tank for a specific asset, in native units and in USD, so you can top it up before withdrawals or sweeps start failing due to insufficient fee reserves.

Path Parameters

string

default:"ETH"

required

The asset identifier of the gas tank to check, as returned by List Gas Tanks. For example: ETH, BNB, POL, TRX.

curl --request GET \
     --url https://api.finrock.io/dac/v1/gas-tank-bal/ETH \
     --header 'Authorization: Token {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: {{api_key}}'

Response

A successful request returns HTTP 200 with the current balance of the specified gas tank.

number

The gas tank balance in the network’s native token (e.g. ETH).

number

The gas tank balance converted to USD.

{
  "balance": 0.00590765,
  "balance_in_usd": 16.0348980890000000
}

Poll this endpoint regularly as part of an automated monitoring workflow and trigger an alert when the balance drops below a safe operating threshold for your transaction volume.