Wallet Actions

Get Transfer Quote

Get a price quote for a cross-asset or cross-chain (DADC) transfer. Only available for named-asset transfers where the source and destination asset or chain differ.

post/v1/wallets/{wallet_id}/transfer/quote

Path parameters

wallet_idstring required

ID of the wallet.

Headers

privy-app-idstring required

ID of your Privy app.

privy-authorization-signaturestring

Request authorization signature. If multiple signatures are required, they should be comma separated.

privy-request-expirystring

Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed.

Request body

amountstring

Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5 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 or output token.

slippage_bpsinteger

Maximum allowed slippage in basis points (1 bps = 0.01%). Only applicable for cross-chain or cross-asset transfers; omit to use the provider default.

Example request

{
  "destination": {
    "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "asset": "usdc",
    "chain": "arbitrum"
  },
  "source": {
    "amount": "10.5",
    "asset": "usdc",
    "chain": "base"
  }
}

Response

Transfer quote retrieved successfully.

amount_type'exact_input' | 'exact_output'

Whether the amount refers to the input token or output token.

estimated_input_amountstring required

Estimated input amount in decimals. For exact_input, this equals source.amount. For exact_output, this is the estimated amount the sender needs to provide.

estimated_output_amountstring required

Estimated output amount in decimals. For exact_input, this is an estimate subject to slippage. For exact_output, this is the guaranteed exact amount to be received.

expires_atnumber required

Quote expiry as Unix timestamp (seconds).

Example response

{
  "destination": {
    "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "asset": "usdc",
    "chain": "arbitrum"
  },
  "estimated_fees": [
    {
      "amount": "0.20",
      "type": "relayer"
    },
    {
      "amount": "0.20",
      "type": "privy"
    },
    {
      "amount": "0.60",
      "recipient": "0x1234567890abcdef1234567890abcdef12345678",
      "type": "developer"
    }
  ],
  "estimated_gas": {
    "amount": "0.0001",
    "base_amount": "100000000000000",
    "gas_asset": "ETH"
  },
  "estimated_input_amount": "10.50",
  "estimated_output_amount": "10.45",
  "expires_at": 1715200000,
  "source": {
    "amount": "10.50",
    "asset": "usdc",
    "chain": "base"
  }
}

Changes

Changed in 5 of the 46 revisions of this API.318

Jul 9, 2026d5a26f68a18a22See the full diff
- ▲
  the response property // became optional for the status
  response-property-became-optional
- ▲
  the response property // became optional for the status
  response-property-became-optional
- ○
  the request property // became optional
  request-property-became-optional
- ○
  the request property // became optional
  request-property-became-optional
Jun 17, 2026468dcf8db5807See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  request property // deprecated
  request-property-deprecated
- ○
  request property // deprecated
  request-property-deprecated
- ○
  the response property became required for the status
  response-property-became-required
- ○
  response property source/anyOf[subschema #1: NamedTokenTransferSource]/amount deprecated
  response-property-deprecated
- ○
  response property source/anyOf[subschema #2: CustomTokenTransferSource]/amount deprecated
  response-property-deprecated
- ○
  added the required property to the response with the status
  response-required-property-added
Jun 8, 202693c7790da9d31See the full diff
- ▲
  the response property became optional for the status
  response-property-became-optional
Jun 3, 2026b64a233ab9ee8See the full diff
- ○
  added to the / request property anyOf list
  request-property-any-of-added
- ○
  added to the // request property anyOf list
  request-property-any-of-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added to the / response property anyOf list for the response status
  response-property-any-of-added
- ○
  added to the /// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added to the /// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added to the /// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added to the // response property anyOf list for the response status
  response-property-any-of-added
May 18, 2026a387f0cce4fa1See the full diff
- ○
  endpoint added
  endpoint-added

Full history