Skip to main content
A fee quote is a signed, time-bound price for the upfront fees on a specific transfer. Requesting one locks in the Fast Transfer fee, the Forwarding Service fee, or both, so you know the exact cost before you submit the transfer. To see where the quote fits in the end-to-end flow, see How upfront fees work.

​
Requesting a quote

Call POST /v2/quote/burn/usdc/{sourceDomainId}/{destDomainId} with these request fields:
  • amount: the USDC transfer amount, in minor units.
  • feeToken: the token you want to pay fees in. Use the zero address (the default) to price the fee in the native gas token, or the source blockchain’s USDC address to price it in USDC.
  • requests: the fees to price. Include a FORWARD request for the Forwarding Service fee, a PRE_FINALITY request for the Fast Transfer fee, or both, with at most one of each type.
The response includes the signedQuote blob you submit onchain, the total fee and fee token, a per-type breakdown, and the quote’s issue time and expiry.
A quote is bound to the exact transfer it prices. Request the quote with the same amount and destination domain you submit onchain. For a FORWARD fee, also match the destination caller and hook data. If any bound value differs when you submit, the transfer reverts.

​
Fee types

You can pay two types of fees upfront, one per service. A FORWARD request requires a destination domain where Forwarding Service is supported, and a PRE_FINALITY request requires a source blockchain available for Fast Transfers. See Supported blockchains for the blockchains that support each service.

​
Quote expiry

Each quote expires after a short, fixed window that depends on the source blockchain. Submit the transfer before the quote expires; otherwise, request a new quote. The following table lists the approximate expiry window for each supported source blockchain. These values are subject to change. A quote’s expiry is either an exact wall-clock time or a source blockchain block number. For a block-number expiry, translating it into remaining time requires knowing the source blockchain and its live block height.