curl --request POST \
--url https://api.privy.io/v1/wallets/{wallet_id}/transfer/quote \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: <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
}
}'
{
"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
}
Quote transfer fees
Get a fee estimate and expected output amount before executing a transfer
curl --request POST \
--url https://api.privy.io/v1/wallets/{wallet_id}/transfer/quote \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: <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
}
}'
{
"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
}
curl --request POST \
--url https://api.privy.io/v1/wallets/{wallet_id}/transfer/quote \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: <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
}
}'
{
"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
}
Authorizations
Basic Auth header with your app ID as the username and your app secret as the password.
Headers
ID of your Privy app.
Request authorization signature. If multiple signatures are required, they should be comma separated.
Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed.
Path Parameters
ID of the wallet.
Body
Request body for requesting a quote for a cross-asset or cross-chain (DADC) transfer.
Source for a transfer identified by a named asset (e.g. "usdc", "eth"). Use this variant for first-class assets maintained by Privy.
- NamedTokenTransferSource
- CustomTokenTransferSource
Show child attributes
Show child attributes
{ "asset": "ousd", "amount": "10.5", "chain": "tempo" }
The destination address for a token transfer. Optionally specify a different asset or chain for cross-asset or cross-chain transfers.
Show child attributes
Show child attributes
{ "address": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" }
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.
100Whether the amount refers to the input token or output token.
exact_input, exact_output 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.
0 <= x <= 10000Optional fee configuration for the transfer. If omitted, cross-chain transfers will not charge additional fees.
Show child attributes
Show child attributes
{ "type": "total_fee_bps", "value": 50 }
Response
Transfer quote retrieved successfully.
Response containing a quote for a cross-asset or cross-chain (DADC) transfer.
Source for a transfer identified by a named asset (e.g. "usdc", "eth"). Use this variant for first-class assets maintained by Privy.
- NamedTokenTransferSource
- CustomTokenTransferSource
Show child attributes
Show child attributes
{ "asset": "ousd", "amount": "10.5", "chain": "tempo" }
The destination address for a token transfer. Optionally specify a different asset or chain for cross-asset or cross-chain transfers.
Show child attributes
Show child attributes
{ "address": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" }
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 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 in USD for the transfer. Only present for cross-chain transfers.
Estimated fee paid to the relayer.
- RelayerFee
- PrivyFee
- DeveloperFee
Show child attributes
Show child attributes
{ "type": "privy", "recipient": "0x1234567890abcdef1234567890abcdef12345678", "amount": "0.20" }
Quote expiry as Unix timestamp (seconds).
Whether the amount refers to the input token or output token.
exact_input, exact_output Estimated source gas cost with full token metadata. Only present for cross-chain transfers.
Show child attributes
Show child attributes
{ "base_amount": "100000000000000", "amount": "0.0001", "gas_asset": "ETH" }
Was this page helpful?