Create crypto deposit account

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"
      }
    }
  ]
}

POST

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.

Deposit address strategy

'dedicated' | 'prefer_destination' | 'require_destination'

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.

Other chain families always use separate source wallets. See where deposit addresses live.

For example, attach an existing deposit configuration and use the destination wallet’s own address:

{
  "type": "deposit_config",
  "deposit_config_id": "<deposit-config-id>",
  "deposit_address_strategy": "prefer_destination"
}

Sign the request body as sent, including 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

Authorization

string

header

required

Basic Auth header with your app ID as the username and your app secret as the password.

Headers

privy-app-id

string

required

ID of your Privy app.

privy-authorization-signature

string

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

privy-request-expiry

string

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

privy-idempotency-key

string

Idempotency keys ensure API requests are executed only once within a 24-hour window.

Path Parameters

wallet_id

string

required

ID of the wallet.

Body

application/json

CreateCryptoDepositAccountWithConfigRequestBody
CreateCryptoDepositAccountWithRouteRequestBody

Creates a crypto deposit account from an existing deposit configuration.

type

enum<string>

required

Available options:

deposit_config

deposit_config_id

string

required

Minimum string length: 1

deposit_address_strategy

enum<string>

How deposit source wallets are chosen. Omission uses dedicated. Destination reuse applies only to the destination's own chain type.

Available options:

dedicated,

prefer_destination,

require_destination

Example:

"dedicated"

Response

200 - application/json

The created crypto deposit account.

Response returned after creating a crypto deposit account.

deposit_accounts

CryptoDepositAddressRoute · object[]

required

Show child attributes

Basics

Wallets

Controls

Identity

Intents

Credit usage

Labs

Create crypto deposit account

Deposit address strategy

Authorizations

Headers

Path Parameters

Body

Response

​Deposit address strategy

Authorizations

Headers

Path Parameters

Body

Response

Deposit address strategy