Video: Estimating gas fees for transactions
Video: Estimating gas fees for transactions
Learn about gas fees, how to estimate them for a transfer using the API, and
how to send USDC using the estimates.
Fee parameters
You have two ways to control what you pay when you create a transfer: fee levels (the simple path) or explicit gas limits (the advanced path).Fee levels
Set thefeeLevel parameter and Circle picks the fee for you based on the level
you choose. Actual wait times vary by blockchain. See
expected confirmation times.
LOW: slower than average, lower fees.MEDIUM: average speed, average fees.HIGH: faster than average, higher fees.
Custom gas limits
Set your own fee parameters instead of picking a level. All values are in wei.gasLimit: the base amount of gas required to process the transaction.priorityFee: an additional tip paid to validators to accelerate the transaction.maxFee: the maximum fee you’re willing to pay per unit of gas. If the network fee exceeds this value, the transaction fails. Solana has nomaxFeeconcept.
EVM blockchains
SpecifygasLimit, maxFee, and priorityFee. Your actual fee is
(base fee + priority fee) × gas used. The network sets the base fee based on
current congestion, so you don’t specify it yourself.
- Base fee: set by the network based on congestion. Burned when the transaction is included, which removes it from circulation.
- Priority fee: additional fee paid to validators to expedite the transaction.
- Max fee: the maximum you’re willing to pay per unit of gas. Protects against excessive prices when the base fee spikes.
priorityFee doesn’t apply on Arbitrum and can be omitted.Solana
Solana’s fee mechanism resembles EIP-1559: specify apriorityFee (in
micro-lamports per compute unit, where one lamport is 10^-9 SOL) to
incentivize validators to include your transaction. There’s no maxFee concept,
and gasLimit is optional. Solana defaults to a compute budget of 200,000
compute units per instruction.
Balance requirements
Every transaction spends the blockchain’s gas token, so your wallet’s balance must cover the network fee. If you’re transferring the gas token itself, the balance must also cover the transfer amount.On Arc, USDC is the native token and has two interfaces that share one balance:
a native 18-decimal interface and an ERC-20 6-decimal interface at
0x3600000000000000000000000000000000000000. Use the ERC-20 token for payments.
Gas fees are charged against the shared balance either way. See
USDC as the native gas token
in the Arc documentation.Estimate the fee before you transfer
A full-balance (“send max”) transfer of a native token always fails because nothing is left to pay the fee. To avoid a failed transfer:- Estimate the fee with the estimate transfer fee API.
- Confirm that
amount + networkFeedoesn’t exceed the wallet’s balance.
155258, or with error
155201 when the wallet has enough of the
transfer token but lacks native tokens for gas.
If the reported balance looks stale, native tokens received through internal or
contract transfers may not be indexed because those transfers emit no standard
transfer event. Contact Circle Support to replay a
missing deposit, or to allowlist the source contract when the same contract
funds the wallet regularly.
Who pays the fee
Who pays the fee depends on the wallet’s account type.Estimated costs
Fees on each blockchain depend on that blockchain’s native token price and the gas cost of the operation you’re running.Native token prices
Six-month trailing average price for each supported blockchain’s native token.Smart Contract Account (SCA) wallets
SCA wallets only run on EVM blockchains. Circle uses lazy deployment: the smart contract account is deployed at the first outbound transaction, so there’s no gas cost at wallet creation or on deposits. Estimated fees for wallet deployment and fungible token transfers on SCA wallets:Externally Owned Account (EOA) wallets
EOA wallet creation is free. Solana and Aptos charge a one-time fee the first time a wallet receives a non-native token:- Solana: the fee creates an Associated Token Account (ATA) and is the network’s rent-exempt minimum for the account. You can recover it by closing the account.
- Aptos: the fee stores the token on the recipient’s account and isn’t recoverable.
Aptos charges an additional storage creation fee when transferring a
fungible token to an address for the first time. The approximate total gas fees
are:
- First transfer to a new address: 0.0005324 APT (~$0.00232 USD)
- Subsequent transfers to the same address: 0.0000002 APT (~$0.00000087 USD)