fee_rate expressed in the units appropriate for the target blockchain (see the table below), and for UTXO chains you must also supply the amount so the API can calculate transaction size. The response returns the total estimated fee denominated in the blockchain’s native token.
Fee Rate Units by Blockchain
Different blockchains use different units for their fee rate parameter. Use the table below to determine the correct unit for yourfee_rate value.
Request
string
required
Your Finrock API key.
string
required
Your JWT bearer token in the format
Bearer {JWT}.string
required
The asset for which to estimate the fee. Use the
asset_name value from the Supported Assets list (e.g. BTC, ETH, USDT_ETH).double
The amount to transfer in the asset’s native unit. Required for UTXO chains (BTC, LTC, DASH, DOGE, BCH) because transaction size — and therefore fee — depends on the number of UTXOs selected to fund the transfer. Optional for non-UTXO chains.
float
required
The desired fee rate, expressed in the unit appropriate for the target blockchain (see the table above). For example, pass
20 for 20 GWei on an EVM chain, or 10 for 10 Sat/Byte on Bitcoin.Example Request
Response
A successful request returns HTTP200 with the estimated fee.
string
The asset for which the fee was estimated.
number
The estimated network fee, denominated in the blockchain’s native token. For token assets (e.g.
USDT_ETH), the fee is returned in ETH, not in USDT.number
The
fee_rate value used for the estimate, echoed back in the response.string
The unit of the
fee_rate used (e.g. GWei, Sat/Byte).Sample 200 Response — ETH
Sample 200 Response — BTC
object
Returned when the
x-api-key or Authorization header is missing or invalid.Sample 401 Response
Fee estimates are approximate and based on current network conditions at the time of the request. The actual fee deducted when the transaction is confirmed may differ if network congestion changes between the estimate and submission.