Fee Structure
Fees are computed per-domain and per-token with two components:
- Flat fee: Fixed amount per spend (inbound and outbound)
- BPS fee: Basis-point fee proportional to the spend amount (inbound and outbound)
Fee Breakdown
Section titled “Fee Breakdown”The SpendFeesBreakdown returned by GetSpendFees includes:
| Field | Description |
|---|---|
total_fees | Total fee amount in the fee token |
usdc_minted | USDC amount to be minted via Circle |
usdc_fees | Fees denominated in USDC |
converted_usdc_fees | USDC fees converted to the fee token |
inbound_fee | Fee charged on the source domain |
outbound_fee | Fee charged on the destination domain |
Auto-Estimation
Section titled “Auto-Estimation”When you omit max_fee from a SpendRequestBuilder, the SDK automatically calls GetSpendFees to estimate the total fee before submitting the spend intent. You can override this by calling .with_max_fee() on the request builder.