curl --request POST \
--url https://api.privy.io/v1/wallets/{wallet_id}/deposit_accounts/crypto \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: <privy-app-id>' \
--data '
{
"type": "inline_route",
"source": {
"mode": "include",
"values": [
{
"asset": "ousd",
"chain": "tempo"
}
]
},
"destination": {
"asset": "pathusd",
"chain": "tempo"
},
"deposit_address_strategy": "prefer_destination"
}
'
{
"deposit_accounts": [
{
"wallet_id": "clg2rvssg025ny5fmul5m95fn",
"deposit_address": "0xF1ff9379AB5838C42D0E9F1AFe32614211788Aae",
"source": {
"mode": "include",
"values": [
{
"asset": "ousd",
"chain": "tempo"
}
]
},
"destination": {
"asset": "pathusd",
"chain": "tempo"
}
}
]
}Crypto
Create crypto deposit account
Create reusable crypto deposit addresses that convert incoming funds into a target asset.
POST
/
v1
/
wallets
/
{wallet_id}
/
deposit_accounts
/
crypto
curl --request POST \
--url https://api.privy.io/v1/wallets/{wallet_id}/deposit_accounts/crypto \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: <privy-app-id>' \
--data '
{
"type": "inline_route",
"source": {
"mode": "include",
"values": [
{
"asset": "ousd",
"chain": "tempo"
}
]
},
"destination": {
"asset": "pathusd",
"chain": "tempo"
},
"deposit_address_strategy": "prefer_destination"
}
'
{
"deposit_accounts": [
{
"wallet_id": "clg2rvssg025ny5fmul5m95fn",
"deposit_address": "0xF1ff9379AB5838C42D0E9F1AFe32614211788Aae",
"source": {
"mode": "include",
"values": [
{
"asset": "ousd",
"chain": "tempo"
}
]
},
"destination": {
"asset": "pathusd",
"chain": "tempo"
}
}
]
}See supported assets and supported chains before creating a deposit address. Use the deposit quote API to preview current route pricing.
Crypto deposit addresses require app-pays gas sponsorship on each source chain. Swap provider fee sponsorship is optional and covers provider fees separately.
For example, attach an existing deposit configuration and use the destination wallet’s own address:
Sign the request body as sent, including
Deposit address strategy
Optional top-level field for both
inline_route and deposit_config requests. Defaults to
dedicated, including when a route already exists.dedicated: Always use a separate source wallet. Privy reuses or creates one for the depositing user.prefer_destination: Use the destination wallet’s own address for its chain family. If the destination wallet was exported, use a separate source wallet.require_destination: Use the destination wallet’s own address for its chain family. If the destination wallet was exported, the request fails.
{
"type": "deposit_config",
"deposit_config_id": "<deposit-config-id>",
"deposit_address_strategy": "prefer_destination"
}
deposit_address_strategy when provided. Do not add a default value after signing.
For source wallet reuse, exported wallets, attached automations, and address changes, see Deposit address behavior.Authorizations
Headers
Body
application/json
- CreateCryptoDepositAccountWithConfigRequestBody
- CreateCryptoDepositAccountWithRouteRequestBody
Creates a crypto deposit account from an existing deposit configuration.
Was this page helpful?

