We refreshed our doc site!

Bookmarked links may have changed

Read release notes

createTransferEstimateFee

Web3 Services
Compliance Engine

Estimate fee for a transfer transaction

POSThttps://api.circle.com/v1/w3s/transactions/transfer/estimateFee

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

Header parameters
X-User-Token
string
Required

Unique system generated JWT session token for specific user.

Body parameters
destinationAddress
string
Required

The destination blockchain address for the transaction.

amounts
array
Required

Transfer amounts in decimal number format, at least one element is required for transfer. For ERC721 token transfer, the amounts field is required to be ["1"] (array with "1" as the only element).

nftTokenIds
array

List of NFT token IDs corresponding with the NFTs to transfer. Batch transfers are supported only for ERC-1155 tokens. The length of NFT token IDs must match the length of amounts.

sourceAddress
string

The source address of the transaction.

tokenId
uuid

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

tokenAddress
string

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

blockchain
string

Blockchain of the transferred token. Required if tokenId is not provided. Excluded with tokenId.

walletId
uuid

Unique system generated identifier of the wallet. Required when source Address and blockchain is not provided. Mutually exclusive. For contract deploys this wallet ID will be used as the source.

Response
RequestChoose a language
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-2024 Circle Technology Services, LLC. All rights reserved.