Skip to main content
The transfer quote endpoint returns a fee breakdown and estimated output amount for a cross-chain or cross-asset transfer before executing it. Use quotes to show users what they will receive and what fees apply before they confirm a transfer.
The quote endpoint is only supported for cross-chain or cross-asset transfers (i.e. those that specify destination.chain or destination.asset). Same-chain, same-asset transfers do not require a quote.

​
Understanding fees

Every cross-chain transfer includes up to three fee components:
  • Relayer fee — paid to the bridge provider for routing the transfer. This varies with network conditions and liquidity.
  • Developer fee — fees to the app developer.
Fees are denominated in USD and deducted from the transfer amount. The estimated_output_amount already reflects all fees — it is what the recipient will receive.

​
Usage

To get a quote via REST API, make a POST request to : 
https://api.privy.io/v1/wallets/{wallet_id}/transfer/quote

​
Body

​
source
object
required
The source asset, amount, and chain for the transfer.
​
destination
object
required
The destination for the transfer.
​
amount
string
Amount as a decimal string in standard units (e.g. "10.0" for 10 USDC). For exact_input, the amount to send. For exact_output, the exact amount to receive. Takes precedence over source.amount when both are provided.
​
amount_type
'exact_input' | 'exact_output'
Whether the amount refers to the input token (exact_input) or the output token (exact_output). Defaults to exact_input. When set to exact_output, the quote returns the estimated source amount needed to deliver the specified destination amount.
​
fee_configuration
object
Optional fee configuration to apply to the transfer.

​
Response

​
amount_type
'exact_input' | 'exact_output'
The amount type from the request, echoed back for clarity.
​
source
object
The source asset, amount, and chain from the request.
​
destination
object
The destination address, asset, and chain from the request.
​
estimated_input_amount
string
The estimated amount the sender provides, as a decimal string in source token units. For exact_input, this equals the source amount. For exact_output, this is the estimated amount needed to deliver the requested destination amount.
​
estimated_output_amount
string
The estimated amount the recipient will receive, as a decimal string in destination token units (e.g. "9.97" for 9.97 USDC). For exact_output, this equals the requested amount.
​
estimated_fees
FeeLineItem[]
An array of fee line items that make up the total transfer cost. Each item has a type and an amount in USD.
​
expires_at
number
Unix timestamp (in seconds) after which the quote is no longer accepted. Executing the transfer before this time gives the best chance of matching the quoted output amount and fees. Quoted amounts are estimates — actual results may vary slightly if market conditions shift between quote and execution.

​
Examples

Quotes are best-effort estimates. Executing a transfer close to the time of the quote improves the likelihood of matching the quoted output and fees, but small deviations are possible if market conditions shift between quote and execution.
const quote = await privy.wallets().transferQuote('insert-wallet-id', {
  amount: '10.0',
  amount_type: 'exact_input',
  source: {
    asset: 'usdc',
    chain: 'tempo',
  },
  destination: {
    address: '0xRecipientAddress',
    chain: 'arbitrum',
  },
  fee_configuration: {
    type: 'total_fee_bps',
    value: 80,
  },
});
To quote a transfer where the recipient receives exactly 100 USDC on Arbitrum, regardless of fees:
const quote = await privy.wallets().transferQuote('insert-wallet-id', {
  amount: '100.0',
  amount_type: 'exact_output',
  source: {
    asset: 'usdc',
    chain: 'tempo',
  },
  destination: {
    address: '0xRecipientAddress',
    chain: 'arbitrum',
  },
});

// quote.estimated_input_amount — estimated source amount needed (e.g. "100.06")
// quote.estimated_output_amount — guaranteed destination amount ("100.0")

​
Quote expiry

Quotes expire quickly — typically within a few minutes. Executing a transfer after expires_at means the quoted output and fees no longer apply — the transfer will proceed but at current market rates. Fetch a fresh quote before each transfer execution.

​
Limitations

The quote endpoint requires either destination.chain or destination.asset to differ from the source. Same-chain, same-asset transfers have no fees to quote.
Transfers using asset_address (custom token contracts) are not supported for cross-chain quotes. Only named assets (usdc, usdt, eth, etc.) can be quoted.

​
API reference

See the API reference for the full parameter reference.