> ## Documentation Index
> Fetch the complete documentation index at: https://docs.privy.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Quote transfer fees
> Get a fee estimate and expected output amount before executing a transfer
```sh cURL theme={"system"}
curl --request POST \
--url https://api.privy.io/v1/wallets/{wallet_id}/transfer/quote \
--header 'Authorization: Basic ' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: ' \
--data '{
"source": {
"asset": "usdc",
"amount": "10.0",
"chain": "base"
},
"destination": {
"address": "0xRecipientAddress",
"chain": "arbitrum"
},
"fee_configuration": {
"type": "total_fee_bps",
"value": 80
}
}'
```
```json 200 theme={"system"}
{
"source": {
"asset": "usdc",
"amount": "10.0",
"chain": "base"
},
"destination": {
"address": "0xRecipientAddress",
"chain": "arbitrum"
},
"estimated_output_amount": "9.94",
"estimated_fees": [
{
"type": "relayer",
"amount": "0.02"
},
{
"type": "developer",
"recipient": "0x1234567890abcdef1234567890abcdef12345678",
"amount": "0.04"
}
],
"expires_at": 1715200000
}
```
## OpenAPI
````yaml post /v1/wallets/{wallet_id}/transfer/quote
openapi: 3.1.0
info:
version: 0.0.1
title: Privy API
description: >-
REST API for Privy's wallet infrastructure — provision and manage wallets
across EVM, Solana, and Bitcoin, authenticate users, sign transactions, and
configure programmable policies and authorization intents.
contact:
name: Privy
url: https://www.privy.io/
email: support@privy.io
servers:
- url: https://api.privy.io
security: []
tags:
- name: Accounts
description: Operations related to asset accounts
- name: Aggregations
description: Operations related to aggregations for tracking and measuring metrics
- name: Apps
description: Operations related to app settings and allowlist management
- name: Client Auth
description: OAuth token exchange and device authorization operations
- name: Condition Sets
description: Operations related to condition sets
- name: Embedded wallets
description: Operations related to embedded wallet creation and authentication
- name: Fiat
description: Operations related to fiat onramping and offramping
- name: Intents
description: Operations related to authorization intents for wallet actions
- name: Key quorums
description: Operations related to key quorums
- name: Kraken Embed
description: >-
Operations for Kraken Embed integration, including quotes, trades, user
management, and portfolio operations
- name: OAuth
description: >-
OAuth 2.0 endpoints including Device Authorization Grant (RFC 8628) for
CLI and limited-input device login flows
- name: Organizations
description: Operations related to organization secret management
- name: Policies
description: Operations related to policies
- name: Shared
description: Common schemas shared across resources
- name: Swaps
description: Operations for swapping tokens within wallets
- name: Transactions
description: Operations related to transactions
- name: User signers
description: Operations related to user signers
- name: Users
description: Operations related to users
- name: Wallet Actions
description: Operations related to wallet actions
- name: Wallets
description: Operations related to wallets
- name: Webhooks
description: >-
Webhook events that Privy sends to your configured endpoint when specific
actions occur in your app
- name: Yield
description: >-
Operations for depositing and withdrawing funds from ERC-4626 yield vaults
(Morpho, Aave)
paths:
/v1/wallets/{wallet_id}/transfer/quote:
post:
tags:
- Wallet Actions
summary: Get Transfer Quote
description: >-
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.
operationId: transferQuote
parameters:
- schema:
type: string
description: ID of the wallet.
required: true
name: wallet_id
in: path
- schema:
type: string
description: ID of your Privy app.
required: true
name: privy-app-id
in: header
- schema:
type: string
description: >-
Request authorization signature. If multiple signatures are
required, they should be comma separated.
required: false
name: privy-authorization-signature
in: header
- schema:
type: string
description: >-
Request expiry. Value is a Unix timestamp in milliseconds
representing the deadline by which the request must be processed.
required: false
name: privy-request-expiry
in: header
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TransferQuoteRequestBody'
example:
source:
asset: usdc
amount: '10.5'
chain: base
destination:
asset: usdc
chain: arbitrum
address: '0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2'
responses:
'200':
description: Transfer quote retrieved successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/TransferQuoteResponse'
example:
source:
asset: usdc
amount: '10.50'
chain: base
destination:
address: '0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2'
asset: usdc
chain: arbitrum
estimated_output_amount: '10.45'
estimated_fees:
- type: relayer
amount: '0.20'
- type: privy
amount: '0.05'
expires_at: 1715200000
security:
- appSecretAuth: []
components:
schemas:
TransferQuoteRequestBody:
type: object
properties:
amount:
type: string
maxLength: 100
description: >-
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:
$ref: '#/components/schemas/AmountType'
source:
$ref: '#/components/schemas/TokenTransferSource'
destination:
$ref: '#/components/schemas/TokenTransferDestination'
slippage_bps:
type: integer
minimum: 0
maximum: 10000
description: >-
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.
fee_configuration:
allOf:
- $ref: '#/components/schemas/FeeConfiguration'
- description: >-
Optional fee configuration for the transfer. If omitted,
cross-chain transfers will not charge additional fees.
required:
- source
- destination
additionalProperties: false
description: >-
Request body for requesting a quote for a cross-asset or cross-chain
(DADC) transfer.
title: TransferQuoteRequestBody
example:
source:
asset: usdc
amount: '10.5'
chain: base
destination:
address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831'
asset: usdc
chain: arbitrum
x-stainless-model: wallets.transfer_quote_request_body
TransferQuoteResponse:
type: object
properties:
amount_type:
$ref: '#/components/schemas/AmountType'
source:
$ref: '#/components/schemas/TokenTransferSource'
destination:
$ref: '#/components/schemas/TokenTransferDestination'
estimated_input_amount:
type: string
description: >-
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_amount:
type: string
description: >-
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.
estimated_fees:
type: array
items:
$ref: '#/components/schemas/FeeLineItem'
description: >-
Estimated fees in USD for the transfer. Only present for cross-chain
transfers.
estimated_gas:
allOf:
- $ref: '#/components/schemas/Gas'
- description: >-
Estimated source gas cost with full token metadata. Only present
for cross-chain transfers.
expires_at:
type: number
description: Quote expiry as Unix timestamp (seconds).
required:
- source
- destination
- estimated_input_amount
- estimated_output_amount
- estimated_fees
- expires_at
additionalProperties: false
description: >-
Response containing a quote for a cross-asset or cross-chain (DADC)
transfer.
title: TransferQuoteResponse
example:
source:
asset: usdc
amount: '10.50'
chain: base
destination:
address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831'
asset: usdc
chain: arbitrum
estimated_input_amount: '10.50'
estimated_output_amount: '10.45'
estimated_fees:
- type: relayer
amount: '0.20'
- type: privy
amount: '0.20'
- type: developer
recipient: '0x1234567890abcdef1234567890abcdef12345678'
amount: '0.60'
estimated_gas:
base_amount: '100000000000000'
amount: '0.0001'
gas_asset: ETH
expires_at: 1715200000
x-stainless-model: wallets.transfer_quote_response
AmountType:
type: string
enum:
- exact_input
- exact_output
description: Whether the amount refers to the input token or output token.
title: AmountType
x-stainless-model: wallets.amount_type
TokenTransferSource:
anyOf:
- $ref: '#/components/schemas/NamedTokenTransferSource'
- $ref: '#/components/schemas/CustomTokenTransferSource'
description: >-
The source asset, amount, and chain for a token transfer. Specify either
`asset` (named) or `asset_address` (custom), not both.
title: TokenTransferSource
example:
asset: usdc
amount: '10.5'
chain: base
x-stainless-model: wallets.token_transfer_source
TokenTransferDestination:
type: object
properties:
address:
anyOf:
- type: string
- type: string
- $ref: '#/components/schemas/TronAddress'
description: >-
Recipient address (hex for EVM, base58 for Solana, base58check for
Tron)
asset:
type: string
description: >-
The destination asset. Required for cross-asset transfers (e.g.,
source 'usdt' to destination 'usdc').
chain:
type: string
description: >-
The destination blockchain network. Required for cross-chain
transfers (e.g., source 'base' to destination 'arbitrum').
required:
- address
additionalProperties: false
description: >-
The destination address for a token transfer. Optionally specify a
different asset or chain for cross-asset or cross-chain transfers.
title: TokenTransferDestination
example:
address: '0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2'
x-stainless-model: wallets.token_transfer_destination
FeeConfiguration:
oneOf:
- $ref: '#/components/schemas/TotalFeeConfigurationBps'
discriminator:
propertyName: type
mapping:
total_fee_bps:
$ref: '#/components/schemas/TotalFeeConfigurationBps'
description: >-
How transfer fees are specified. If omitted, a default fee configuration
is applied.
title: FeeConfiguration
example:
type: total_fee_bps
value: 50
x-stainless-model: wallets.fee_configuration
FeeLineItem:
oneOf:
- $ref: '#/components/schemas/RelayerFee'
- $ref: '#/components/schemas/PrivyFee'
- $ref: '#/components/schemas/DeveloperFee'
discriminator:
propertyName: type
mapping:
relayer:
$ref: '#/components/schemas/RelayerFee'
privy:
$ref: '#/components/schemas/PrivyFee'
developer:
$ref: '#/components/schemas/DeveloperFee'
description: An individual fee assessed on a transfer.
title: FeeLineItem
example:
type: privy
amount: '0.20'
x-stainless-model: wallets.fee_line_item
Gas:
type: object
properties:
base_amount:
type: string
description: Gas cost in the gas token's base units (e.g. wei).
amount:
type: string
description: >-
Gas cost in the gas token as a human-readable decimal string (e.g.
"0.0001").
gas_asset:
type: string
description: Gas token symbol (e.g. "ETH", "USDC").
required:
- base_amount
- amount
- gas_asset
additionalProperties: false
description: >-
Gas cost for a blockchain action. Includes both raw base-unit amount and
a human-readable decimal string, plus the gas token symbol.
title: Gas
example:
base_amount: '100000000000000'
amount: '0.0001'
gas_asset: ETH
x-stainless-model: wallets.gas
NamedTokenTransferSource:
type: object
properties:
amount:
type: string
maxLength: 100
description: >-
Amount as a decimal string in the token's standard unit (e.g. "1.5"
for 1.5 USDC, "0.01" for 0.01 ETH). For exact_input, specifies the
amount to send. Not in the smallest on-chain unit (wei, lamports,
etc.). Maximum 100 characters.
deprecated: true
chain:
type: string
description: >-
The blockchain network on which to perform the transfer. Supported
chains include: 'ethereum', 'base', 'arbitrum', 'polygon', 'solana',
and their respective testnets.
asset:
type: string
description: >-
The asset to transfer. Supported: 'usdc', 'usdb', 'usdt'
(stablecoins), 'eth' (native Ethereum), 'sol' (native Solana).
required:
- amount
- chain
- asset
additionalProperties: false
description: >-
Source for a transfer identified by a named asset (e.g. "usdc", "eth").
Use this variant for first-class assets maintained by Privy.
title: NamedTokenTransferSource
example:
asset: usdc
amount: '10.5'
chain: base
x-stainless-model: wallets.named_token_transfer_source
CustomTokenTransferSource:
type: object
properties:
amount:
type: string
maxLength: 100
description: >-
Amount as a decimal string in the token's standard unit (e.g. "1.5"
for 1.5 USDC, "0.01" for 0.01 ETH). For exact_input, specifies the
amount to send. Not in the smallest on-chain unit (wei, lamports,
etc.). Maximum 100 characters.
deprecated: true
chain:
type: string
description: >-
The blockchain network on which to perform the transfer. Supported
chains include: 'ethereum', 'base', 'arbitrum', 'polygon', 'solana',
and their respective testnets.
asset_address:
anyOf:
- type: string
- type: string
- $ref: '#/components/schemas/TronAddress'
description: >-
The token contract address (EVM) or mint address (Solana) of the
asset to transfer.
required:
- amount
- chain
- asset_address
additionalProperties: false
description: >-
Source for a transfer identified by a token contract address (EVM) or
mint address (Solana). Use this variant for tokens that are not
first-class assets.
title: CustomTokenTransferSource
example:
asset_address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
amount: '10.5'
chain: base
x-stainless-model: wallets.custom_token_transfer_source
TronAddress:
type: string
pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
description: 'Tron address: base58check-encoded, starting with T, 34 characters.'
title: TronAddress
x-stainless-model: shared.tron_address
TotalFeeConfigurationBps:
type: object
properties:
type:
type: string
enum:
- total_fee_bps
description: 'Discriminator: total fee specified in BPS.'
value:
type: integer
minimum: 0
maximum: 10000
description: Total fee in basis points (1 bps = 0.01%).
required:
- type
- value
additionalProperties: false
description: Total fees assessed on a transfer, in BPS
title: TotalFeeConfigurationBps
example:
type: total_fee_bps
value: 50
x-stainless-model: wallets.total_fee_configuration_bps
RelayerFee:
type: object
properties:
type:
type: string
enum:
- relayer
recipient:
anyOf:
- type: string
- type: string
- $ref: '#/components/schemas/TronAddress'
amount:
type: string
description: Amount in USD (in decimals).
required:
- type
- amount
additionalProperties: false
description: Estimated fee paid to the relayer.
title: RelayerFee
example:
type: relayer
recipient: '0x1234567890abcdef1234567890abcdef12345678'
amount: '0.20'
x-stainless-model: wallets.relayer_fee
PrivyFee:
type: object
properties:
type:
type: string
enum:
- privy
recipient:
anyOf:
- type: string
- type: string
- $ref: '#/components/schemas/TronAddress'
amount:
type: string
description: Amount in USD (in decimals).
required:
- type
- amount
additionalProperties: false
description: Estimated fee paid to Privy.
title: PrivyFee
example:
type: privy
amount: '0.20'
x-stainless-model: wallets.privy_fee
DeveloperFee:
type: object
properties:
type:
type: string
enum:
- developer
recipient:
anyOf:
- type: string
- type: string
- $ref: '#/components/schemas/TronAddress'
amount:
type: string
description: Amount in USD (in decimals).
required:
- type
- amount
additionalProperties: false
description: Estimated fee paid to the developer.
title: DeveloperFee
example:
type: developer
recipient: '0x1234567890abcdef1234567890abcdef12345678'
amount: '0.20'
x-stainless-model: wallets.developer_fee
securitySchemes:
appSecretAuth:
type: http
scheme: basic
description: >-
Basic Auth header with your app ID as the username and your app secret
as the password.
````