GET

Get fee estimate

Returns the estimated fee for a transaction. UTXO coins will return a fee per kB, while Account-based coins will return a flat fee estimate.

The fee estimate provided by BitGo is higher than the usual network fee. This additional fee is not charged by BitGo but is used to ensure that the transactions are processed faster and do not fail on the blockchain network.

Path Params

coin string required

A cryptocurrency or token ticker symbol.

Query Params

numBlocks integer

target number of blocks
recipient string

Recipient of the tx to estimate for (only for ETH)
data string

ETH data of the tx to estimate for (only for ETH)
amount string

Amount in base units being sent to estimate for (only for ETH)
hop boolean

True if we are estimating for a hop tx, false or unspecified for a wallet tx (ETH, AVAXC and POLYGON)

Responses

200

Response Body

ONE OF

feePerKb integer required

(BTC only) The fee (in base units) per kilobyte (or virtual kilobyte) required to confirm a transaction on 2 or more blocks.
cpfpFeePerKb integer

(BTC only) Child-Pays-For-Parent (CPFP) fee (in base units) per kilobyte (or virtual kilobyte). Includes the fees for all unconfirmed transactions dependent on the CPFP transaction.
numBlocks integer required

(BTC only) The number of blocks required to confirm a transaction. You can use numBlocks to estimate the fee rate by targeting confirmation within a given number of blocks. If both feeRate and numBlocks are absent, the transaction defaults to 2 blocks for confirmation.

Note: The maxFeeRate limits the fee rate generated by numBlocks.
confidence integer

(BTC only) The confidence (as a percentage) in the accuracy of the fee estimate.

>= 0 · <= 100
feeByBlockTarget object

(UTXO only) Custom multiplier to the feeRate. The resulting fee rate is limited by the maxFeeRate. For replace-by-fee (RBF) transactions (that include rbfTxIds), the feeMultiplier must be greater than 1, since it's an absolute fee multiplier to the transaction being replaced.

Note: The maxFeeRate limits the fee rate generated by feeMultiplier.

feeEstimate string required

fee estimate for a transaction for the given account-based coin, denominated in the base units of that coin (i.e. Drops for XRP, Stroops for XLM, etc)

feeRate integer required

Calculated by transaction size. Fee rate is in microAlgo (base unit).
minimumFee integer required

Always 1000.

Defaults to 1000

feeEstimate string required

fee estimate for a transaction for the given account-based coin, denominated in base units (i.e. Wei)
gasLimitEstimate string

The amount of gas that the transaction will use, if recipient is provided in the request
minGasPrice string required

minimum gas price that can be provided in base units
minGasLimit string required

minimum gas limit that can be provided in base units
maxGasLimit string required

maximum gas limit that can be provided in base units
minGasIncreaseBy string required

gas price must not be increased by less than this after being introduced to the network
eip1559 object

EIP 1559 fee estimates
eip1559 object
- baseFee string required
  
  Block base fees, in base units (i.e. Wei), per gas. Zeroes are returned for pre-EIP-1559 blocks
- gasUsedRatio string required
  
  Block gas used ratio. Calculated as the ratio of gasUsed and gasLimit
- safeLowMinerTip string
  
  25th percentile of the tips spent in the last block
- normalMinerTip string
  
  35th percentile of the tips spent in the last block
- standardMinerTip string
  
  50th percentile of the tips spent in the last block
- fastestMinerTip string
  
  75th percentile of the tips spent in the last block
- ludicrousMinerTip string
  
  97th percentile of the tips spent in the last block

fee integer required

Maximum fee for a payment transaction, denominated in base units (i.e. sun). It varies for TRX and TRC20 Token based on the coin parameter
newAccountFee integer required

Fee for wallet initialization
netFee integer required

Fee rate per unit of tx size. Not used currently (fee is a maximum limit, the network charges the cost of the transaction)

400

Bad Request

Response Body

object

error string required

Human-readable error message
requestId string required

Client request id
context object

Properties that apply to a specific error name
name string required

Error code

curl --request GET \ --url 'https://app.bitgo-test.com/api/v2/coin/tx/fee&numBlocks=0&recipient=string&data=string&amount=string&hop=true' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

const url = 'https://app.bitgo-test.com/api/v2/coin/tx/fee&numBlocks=0&recipient=string&data=string&amount=string&hop=true'; const options = {method: 'GET', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}}; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error(err));

require 'uri' require 'net/http' url = URI("https://app.bitgo-test.com/api/v2/coin/tx/fee&numBlocks=0&recipient=string&data=string&amount=string&hop=true") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('GET', 'https://app.bitgo-test.com/api/v2/coin/tx/fee&numBlocks=0&recipient=string&data=string&amount=string&hop=true', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', ], ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/v2/coin/tx/fee&numBlocks=0&recipient=string&data=string&amount=string&hop=true" headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN" } response = requests.get(url, headers=headers) print(response.text)