SDK Explorer

Estimates gas fees that will be incurred for a transfer transaction; given its amount, blockchain, and token.

Parameters
input
object
Required

Represents the input parameters for estimating transfer fees.

option 1:
tokenId
string
Required

System generated identifier of the token. Excluded with tokenAddress and tokenBlockchain.

amount
array of strings
Required

Specifies the transfer amount in decimal format.

destinationAddress
string
Required

The recipient's blockchain address.

nftTokenIds
array of strings

The list of NFT IDs to be transferred/batchTransferred for NFT withdrawal. Note: Only ERC-1155 tokens support safeBatchTransferFrom.

sourceAddress
string

The source blockchain address of the transaction.

walletId
string

Identifier for the originating wallet.

option 2:
blockchain
string

Blockchain of the transferred token. Required if tokenId is not provided. The blockchain and tokenId fields are mutually exclusive.

Allowed valuesARBARB-SEPOLIAAVAXAVAX-FUJIBASEBASE-SEPOLIAETHETH-SEPOLIAMATICMATIC-AMOYOPOP-SEPOLIASOLSOL-DEVNETUNIUNI-SEPOLIA
tokenAddress
string
Required

Blockchain address of the transferred token. Empty for native tokens. Excluded with tokenId.

amount
array of strings
Required

Specifies the transfer amount in decimal format.

destinationAddress
string
Required

The recipient's blockchain address.

nftTokenIds
array of strings

The list of NFT IDs to be transferred/batchTransferred for NFT withdrawal. Note: Only ERC-1155 tokens support safeBatchTransferFrom.

sourceAddress
string

The source blockchain address of the transaction.

walletId
string

Identifier for the originating wallet.

Responses
Example
1const response = await client.estimateTransferFee({
2  amount: ['0.01'],
3  destinationAddress: '656d6fd6-d430-459c-9ba4-5c2074433f1b',
4  tokenId: '9606f293-5b81-4970-acd3-c35c157461c2',
5})
6console.log(response.data)
ResponseChoose an example
1{
2  "data": {
3    "high": {
4      "gasLimit": "21000",
5      "gasPrice": "",
6      "maxFee": "5.935224468",
7      "priorityFee": "1.022783914",
8      "baseFee": "1.022783914",
9      "networkFee": "0.0001246397138"
10    },
11    "low": {
12      "gasLimit": "21000",
13      "gasPrice": "",
14      "maxFee": "5.935224468",
15      "priorityFee": "1.022783914",
16      "baseFee": "1.022783914",
17      "networkFee": "0.0001246397138"
18    },
19    "medium": {
20      "gasLimit": "21000",
21      "gasPrice": "",
22      "maxFee": "5.935224468",
23      "priorityFee": "1.022783914",
24      "baseFee": "1.022783914",
25      "networkFee": "0.0001246397138"
26    },
27    "callGasLimit": "69222",
28    "verificationGasLimit": "56863",
29    "preVerificationGas": "44112"
30  }
31}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.