SDK Explorer

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

Parameters
EstimateTransferTransactionFeeRequest
object
Required
amounts
array of strings
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).

destination_address
string
Required

Blockchain generated unique identifier, associated with wallet (account), smart contract or other blockchain objects.

nft_token_ids
array of strings

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.

source_address
string

Source address of the transaction. Required along with blockchain if walletId is not provided. The sourceAddress and walletId fields are mutually exclusive.

token_id
string

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

token_address
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. The blockchain and tokenId fields are mutually exclusive.

Allowed valuesETHETH-SEPOLIAAVAXAVAX-FUJIMATICMATIC-AMOYSOLSOL-DEVNETARBARB-SEPOLIAUNIUNI-SEPOLIABASEBASE-SEPOLIAOPOP-SEPOLIA
wallet_id
string

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

Responses
Example
1from circle.web3 import developer_controlled_wallets
2from circle.web3 import utils
3
4client = utils.init_developer_controlled_wallets_client(api_key=key, entity_secret=entitySecret)
5
6api_instance = developer_controlled_wallets.TransactionsApi(client)
7
8request = developer_controlled_wallets.EstimateTransferTransactionFeeRequest.from_dict({
9    "amounts": ["0.0000001"],
10    "destinationAddress": "0xe94ff4f83d7ecb9d9e0bcd59731c1fba4c69c404",
11    "feeLevel": "HIGH",
12    "tokenId": "979869da-9115-5f7d-917d-12d434e56ae7",
13    "walletId": "301e9038-e4c3-5a77-a9fe-95fd644f4c85",
14})
15response = api_instance.create_transfer_estimate_fee(estimate_transfer_transaction_fee_request=request)
16print(response.json())
17
ResponseChoose an example
1{
2  "data": {
3    "high": {
4      "gas_limit": "21000",
5      "gas_price": "",
6      "max_fee": "5.935224468",
7      "priority_fee": "1.022783914",
8      "base_fee": "1.022783914",
9      "network_fee": "0.0001246397138"
10    },
11    "low": {
12      "gas_limit": "21000",
13      "gas_price": "",
14      "max_fee": "5.935224468",
15      "priority_fee": "1.022783914",
16      "base_fee": "1.022783914",
17      "network_fee": "0.0001246397138"
18    },
19    "medium": {
20      "gas_limit": "21000",
21      "gas_price": "",
22      "max_fee": "5.935224468",
23      "priority_fee": "1.022783914",
24      "base_fee": "1.022783914",
25      "network_fee": "0.0001246397138"
26    },
27    "call_gas_limit": "69222",
28    "verification_gas_limit": "56863",
29    "pre_verification_gas": "44112"
30  }
31}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.