Blockchain fees

Estimate fee for transaction

10 credits per API call.


Estimate current transaction fee for different operations.
Supported blockchains:

  • Bitcoin
  • Litecoin
  • Harmony.ONE
  • The XDC Network
  • Ethereum
  • Celo
  • Klaytn
  • Binance Smart Chain
  • Polygon
  • Elrond

SecurityX-API-Key
Request
Request Body schema: application/json
One of:
chain
required
string

Blockchain to estimate fee for.

Enum: "CELO" "ETH" "BSC" "XDC" "ONE" "MATIC" "KLAY"
type
required
string

Type of transaction

Enum: "DEPLOY_ERC20" "DEPLOY_NFT" "MINT_NFT" "BURN_NFT" "TRANSFER_NFT" "TRANSFER_ERC20" "DEPLOY_AUCTION" "DEPLOY_MARKETPLACE"
sender
string = 42 characters

Sender address, if type is TRANSFER_ERC20

recipient
string = 42 characters

Blockchain address to send assets, if type is TRANSFER_ERC20

contractAddress
string = 42 characters

Contract address of ERC20 token, if type is TRANSFER_ERC20

amount
string^[+]?((\d+(\.\d*)?)|(\.\d+))$

Amount to be sent in ERC20, if type is TRANSFER_ERC20

Responses
200

OK

400

Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.

401

Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403

Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.

500

Internal server error. There was an error on the server while processing the request.

post/v3/blockchain/estimate
Request samples
application/json
{
  • "chain": "CELO",
  • "type": "DEPLOY_ERC20",
  • "sender": "0xfb99f8ae9b70a0c8cd96ae665bbaf85a7e01a2ef",
  • "recipient": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
  • "contractAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
  • "amount": "100000"
}
Response samples
application/json
{
  • "fast": "0.006584",
  • "medium": "0.004584",
  • "slow": "0.002584"
}

Estimate ethereum transaction fees

10 credits per API call.


Estimate gasLimit and gasPrice of the Ethereum transaction. Gas price is obtained from multiple sources + calculated based on the latest N blocks and the current mempool state. The fast one is used by default.

SecurityX-API-Key
Request
header Parameters
x-testnet-type
string
Default: ethereum-ropsten

Type of Ethereum testnet. Defaults to ethereum-ropsten.

Enum: "ethereum-ropsten" "ethereum-rinkeby"
Request Body schema: application/json
from
required
string = 42 characters

Sender address.

to
required
string = 42 characters

Blockchain address to send assets

contractAddress
string = 42 characters

Contract address of ERC20 token, if transaction is ERC20 token

amount
required
string^[+]?((\d+(\.\d*)?)|(\.\d+))$

Amount to be sent in Ether or ERC20.

data
string <= 50000 characters ^(0x|0h)?[0-9A-F]+$

Additinal data, that can be passed to blockchain transaction as data property. Only for ETH transactions.

Responses
200

OK

400

Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.

401

Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403

Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.

500

Internal server error. There was an error on the server while processing the request.

post/v3/ethereum/gas
Request samples
application/json
{
  • "from": "0xfb99f8ae9b70a0c8cd96ae665bbaf85a7e01a2ef",
  • "to": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
  • "contractAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
  • "amount": "100000",
  • "data": "My note to recipient."
}
Response samples
application/json
{
  • "gasLimit": "40000",
  • "gasPrice": "20000000000",
  • "estimations": {
    }
}

Estimate multiple transaction fees

10 credits per API call + 10 credits per each gas estimation.


Estimate gasLimit and gasPrice of the Ethereum transaction. Gas price is obtained from multiple sources + calculated based on the latest N blocks and the current mempool state. The fast one is used by default.
Result is calculated in the order of the request array items.

SecurityX-API-Key
Request
header Parameters
x-testnet-type
string
Default: ethereum-ropsten

Type of Ethereum testnet. Defaults to ethereum-ropsten.

Enum: "ethereum-ropsten" "ethereum-rinkeby"
Request Body schema: application/json
Array of objects (EthEstimateGas)
Array
from
required
string = 42 characters

Sender address.

to
required
string = 42 characters

Blockchain address to send assets

contractAddress
string = 42 characters

Contract address of ERC20 token, if transaction is ERC20 token

amount
required
string^[+]?((\d+(\.\d*)?)|(\.\d+))$

Amount to be sent in Ether or ERC20.

data
string <= 50000 characters ^(0x|0h)?[0-9A-F]+$

Additinal data, that can be passed to blockchain transaction as data property. Only for ETH transactions.

Responses
200

OK

400

Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.

401

Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403

Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.

500

Internal server error. There was an error on the server while processing the request.

post/v3/ethereum/gas/batch
Request samples
application/json
{
  • "estimations": [
    ]
}
Response samples
application/json
{
  • "error": true,
  • "result": [
    ]
}

Estimate Polygon transaction fees

2 credits per API call.


Estimate gasLimit and gasPrice of the Polygon transaction. Gas price is obtained from https://gasstation-mainnet.matic.network/.

SecurityX-API-Key
Request
Request Body schema: application/json
from
required
string = 66 characters

Sender address.

to
required
string = 42 characters

Blockchain address to send assets

amount
required
string^[+]?((\d+(\.\d*)?)|(\.\d+))$

Amount to be sent in Ether.

data
string <= 50000 characters ^(0x|0h)?[0-9A-F]+$

Additinal data, that can be passed to blockchain transaction as data property. Only for ETH transactions.

Responses
200

OK

400

Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.

401

Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403

Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.

500

Internal server error. There was an error on the server while processing the request.

post/v3/polygon/gas
Request samples
application/json
{
  • "from": "0xfb99f8ae9b70a0c8cd96ae665bbaf85a7e01a2ef",
  • "to": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
  • "amount": "100000",
  • "data": "My note to recipient."
}
Response samples
application/json
{
  • "gasLimit": "40000",
  • "gasPrice": "20"
}

Estimate BNB Chain transaction fees

2 credits per API call.


Estimate gasLimit and gasPrice of the BSC transaction. Gas price is obtained from https://explorer.bitquery.io/bsc/gas.

SecurityX-API-Key
Request
Request Body schema: application/json
from
required
string = 66 characters

Sender address.

to
required
string = 42 characters

Blockchain address to send assets

amount
required
string^[+]?((\d+(\.\d*)?)|(\.\d+))$

Amount to be sent in Ether.

data
string <= 50000 characters ^(0x|0h)?[0-9A-F]+$

Additinal data, that can be passed to blockchain transaction as data property. Only for ETH transactions.

Responses
200

OK

400

Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.

401

Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403

Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.

500

Internal server error. There was an error on the server while processing the request.

post/v3/bsc/gas
Request samples
application/json
{
  • "from": "0xfb99f8ae9b70a0c8cd96ae665bbaf85a7e01a2ef",
  • "to": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
  • "amount": "100000",
  • "data": "My note to recipient."
}
Response samples
application/json
{
  • "gasLimit": "40000",
  • "gasPrice": "20"
}

Estimate Klaytn transaction fees

2 credits per API call.


Estimate gasLimit and gasPrice of the Klaytn transaction. Gas price is obtained from https://gasstation-mainnet.matic.network/.

SecurityX-API-Key
Request
Request Body schema: application/json
from
required
string = 66 characters

Sender address.

to
required
string = 42 characters

Blockchain address to send assets

amount
required
string^[+]?((\d+(\.\d*)?)|(\.\d+))$

Amount to be sent in Ether.

data
string <= 50000 characters ^(0x|0h)?[0-9A-F]+$

Additinal data, that can be passed to blockchain transaction as data property. Only for ETH transactions.

Responses
200

OK

400

Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.

401

Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403

Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.

500

Internal server error. There was an error on the server while processing the request.

post/v3/klaytn/gas
Request samples
application/json
{
  • "from": "0xfb99f8ae9b70a0c8cd96ae665bbaf85a7e01a2ef",
  • "to": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
  • "amount": "100000",
  • "data": "My note to recipient."
}
Response samples
application/json
{
  • "gasLimit": "40000",
  • "gasPrice": "20"
}

Estimate XDC transaction fees

2 credits per API call.


Estimate gasLimit and gasPrice of the XDC transaction. Gas price is obtained from https://rpc.xinfin.network/gasPrice.

SecurityX-API-Key
Request
Request Body schema: application/json
from
required
string = 66 characters

Sender address.

to
required
string [ 42 .. 43 ] characters

Blockchain address to send assets

amount
required
string^[+]?((\d+(\.\d*)?)|(\.\d+))$

Amount to be sent in Ether.

data
string <= 50000 characters ^(0x|0h)?[0-9A-F]+$

Additinal data, that can be passed to blockchain transaction as data property. Only for ETH transactions.

Responses
200

OK

400

Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.

401

Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403

Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.

500

Internal server error. There was an error on the server while processing the request.

post/v3/xdc/gas
Request samples
application/json
{
  • "from": "xdcfb99f8ae9b70a0c8cd96ae665bbaf85a7e01a2ef",
  • "to": "xdc687422eEA2cB73B5d3e242bA5456b782919AFc85",
  • "amount": "100000",
  • "data": "My note to recipient."
}
Response samples
application/json
{
  • "gasLimit": "40000",
  • "gasPrice": "5"
}

Estimate Kcs transaction fees

2 credits per API call.


Estimate gasLimit and gasPrice of the Kcs transaction.

SecurityX-API-Key
Request
Request Body schema: application/json
from
required
string = 66 characters

Sender address.

to
required
string = 42 characters

Blockchain address to send assets

amount
required
string^[+]?((\d+(\.\d*)?)|(\.\d+))$

Amount to be sent in Ether.

data
string <= 50000 characters ^(0x|0h)?[0-9A-F]+$

Additinal data, that can be passed to blockchain transaction as data property. Only for ETH transactions.

Responses
200

OK

400

Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.

401

Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403

Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.

500

Internal server error. There was an error on the server while processing the request.

post/v3/kcs/gas
Request samples
application/json
{
  • "from": "0xfb99f8ae9b70a0c8cd96ae665bbaf85a7e01a2ef",
  • "to": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
  • "amount": "100000",
  • "data": "My note to recipient."
}
Response samples
application/json
{
  • "gasLimit": "40000",
  • "gasPrice": "20"
}

Estimate VeChain Gas for transaction

5 credits per API call.


Estimate gas required for transaction.

SecurityX-API-Key
Request
Request Body schema: application/json
from
required
string <= 50 characters

Sender account address.

to
required
string <= 50 characters

Recipient account address.

value
required
string <= 50 characters

Amount to send.

data
string <= 10000 characters

Data to send to Smart Contract

nonce
number

Nonce

Responses
200

OK

400

Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.

401

Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403

Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.

500

Internal server error. There was an error on the server while processing the request.

post/v3/vet/transaction/gas
Request samples
application/json
{
  • "from": "0x5034aa590125b64023a0262112b98d72e3c8e40e",
  • "to": "0x5034aa590125b64023a0262112b98d72e3c8e40e",
  • "value": "140",
  • "data": "string",
  • "nonce": 12345
}
Response samples
application/json
21000

Get QTUM estimated gas fees

1 credit per API call.


Get estimated gas fees

SecurityX-API-Key
Request
path Parameters
nblocks
required
number

nblocks

Example: 1
Responses
200

OK

400

Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.

401

Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403

Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.

500

Internal server error. There was an error on the server while processing the request.

get/v3/qtum/transactions/gas/{nblocks}
Request samples
curl -i -X GET \
  'https://api-eu1.tatum.io/v3/qtum/transactions/gas/{nblocks}' \
  -H 'x-api-key: YOUR_API_KEY_HERE'
Response samples
application/json
{ }

Get QTUM estimated gas fees per byte

1 credit per API call.


Get estimated gas fees per byte

SecurityX-API-Key
Request
path Parameters
nblocks
required
number

nblocks

Example: 1
Responses
200

OK

400

Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.

401

Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403

Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.

500

Internal server error. There was an error on the server while processing the request.

get/v3/qtum/transactions/gasbytes/{nblocks}
Request samples
curl -i -X GET \
  'https://api-eu1.tatum.io/v3/qtum/transactions/gasbytes/{nblocks}' \
  -H 'x-api-key: YOUR_API_KEY_HERE'
Response samples
application/json
{ }