create_transfer_estimate_fee

SDK Explorer

Developer Controlled Wallets

Getting Started

Methods Overview

Health

Webhook Subscriptions

Monitor Tokens

Developer Account

Faucet

Wallet Sets

Wallets

Signing

Transactions

Token Lookup

create_transfer_estimate_feePython,latest

Go to PyPI

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

Parameters

EstimateTransferTransactionFeeRequest

object

Required

Show 8 properties

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.

x_request_id

string

Developer-provided parameter used to identify this request. Useful when communicating with Circle Support.

Responses

200EstimateTransactionFeeResponse

Response Body

object

data

object

Required

Show 6 properties

high

object

Show 6 properties

gas_limit

string

The maximum units of gas to use for the transaction. Required if feeLevel is not provided. Estimates for this limit can be obtained through the POST /transactions/transfer/estimateFee API. GasLimit override (only supported for EOA wallets): Using gasLimit together with feeLevel, the provided gasLimit is required to be greater or equal to feeLevel estimation and will override the estimation's gasLimit.

gas_price

string

For blockchains without EIP-1559 support, the maximum price of gas, in gwei, to use per each unit of gas (see gasLimit). Requires gasLimit. Cannot be used with feeLevel, priorityFee, or maxFee. Estimates for this fee can be obtained through the POST /transactions/transfer/estimateFee API.

max_fee

string

For blockchains with EIP-1559 support, the maximum price per unit of gas (see gasLimit), in gwei. Requires priorityFee, and gasLimit to be present. Cannot be used with feeLevel or gasPrice. Estimates for this fee can be obtained through the POST /transactions/transfer/estimateFee API.

priority_fee

string

For blockchains with EIP-1559 support, the “tip”, in gwei, to add to the base fee as an incentive for validators. Please note that the maxFee and gasLimit parameters are required alongside the priorityFee. The feeLevel and gasPrice parameters cannot be used with the priorityFee. Estimations for this fee can be obtained through the POST /transactions/transfer/estimateFee API.

base_fee

string

For blockchains with EIP-1559 support, the estimated base fee represents the minimum fee required for a transaction to be included in a block on the blockchain. It is measured in gwei and compensates for the computational resources validators consume to process the transaction. The base fee is supplemented by a separate "tip" called the priority fee, which acts as an extra incentive for validators to prioritize the transaction. The priority fee is added to the base fee to calculate the final transaction fee.

network_fee

string

The estimated network fee is the maximum amount of cryptocurrency (such as ETH, ARB, or SOL) that you will pay for your transaction. This fee depends on the parameters you set, including Gas Limit, Priority Fee, and Max Fee. It compensates for the computational resources that validators consume to process the transaction. It is measured in native token such as ETH, SOL. For blockchains with L1 data fees such as OP/BASE, the network fee is a combination of the Execution Gas Fee and the L1 Data Fee. Each blockchain might use different formula for network fee. Refer to each specific blockchain's documentation to understand how networkFee is calculated.

low

object

Show 6 properties

gas_limit

string

gas_price

string

max_fee

string

priority_fee

string

base_fee

string

network_fee

string

medium

object

Show 6 properties

gas_limit

string

gas_price

string

max_fee

string

priority_fee

string

base_fee

string

network_fee

string

call_gas_limit

string

One of ERC-4337 gas fields. The amount of gas to allocate for the main execution call. Only in smart contract account estimation response.

verification_gas_limit

string

One of ERC-4337 gas fields. The amount of gas to allocate for the verification step. Only in smart contract account estimation response.

pre_verification_gas

string

One of ERC-4337 gas fields. The amount of gas to pay to compensate the bundler for pre-verification execution and call data. Only in smart contract account estimation response.

400Error

404NotFoundResponse

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?

Developer Terms Service Terms Privacy Policy Acceptable Use Your Privacy Choices

Cookie Policy