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

200
400
401
403
500

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

200
400
401
403
500

application/json

{"gasLimit": "40000",
"gasPrice": "20000000000",
"estimations": {"safe": "20000000000",
"standard": "40000000000",
"fast": "55000000000",
"baseFee": "55000000000"
}
}

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": [{"from": "0xfb99f8ae9b70a0c8cd96ae665bbaf85a7e01a2ef",
"to": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
"contractAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
"amount": "100000",
"data": "My note to recipient."
}
]
}

Response samples

200
400
401
403
500

application/json

{"error": true,
"result": [{"error": true,
"msg": "Provided address 0xt16360210b423d3a5205923d6e64a2d142d9f426 is invalid, the capitalization checksum test failed, or it's an indirect IBAN address which can't be converted."
},
{"error": false,
"contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"data": {"gasLimit": "63185",
"gasPrice": "119104833751",
"estimations": {"safe": "100833333333",
"standard": "104833333333",
"fast": "119104833751",
"baseFee": "119104833751"
}
}
}
]
}

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

200
400
401
403
500

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

200
400
401
403
500

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

200
400
401
403
500

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

200
400
401
403
500

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

200
400
401
403
500

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

200
400
401
403
500

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

200
400
401
403
500

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

200
400
401
403
500

application/json

{ }