Create a crypto deposit account

A crypto deposit account gives a wallet persistent deposit addresses. When receiving deposits on the same chain type as the wallet, the deposit address is the wallet itself. When receiving deposits on a different chain type as the wallet, the deposit address is a newly provisioned wallet assigned to the same owner. The request body includes:

object

required

Assets the deposit address accepts. Chains must be EVM or Solana.

Hide properties

'all' | 'include' | 'exclude'

required

include accepts only the listed assets. exclude accepts all except the listed assets. all accepts every supported source.

object[]

Asset specs for include and exclude. Omit when mode is all.

Hide properties

string

Omit to match every supported chain for that asset.

object

required

Asset delivered to the destination wallet. Identifies exactly one asset on exactly one chain.

Hide properties

string

required

string

required

Must match the destination wallet’s chain_type.

import {PrivyClient} from '@privy-io/node';

const userJwt = 'insert-user-jwt';
const walletId = 'insert-wallet-id';

const privy = new PrivyClient({
  appId: 'insert-your-app-id',
  appSecret: 'insert-your-app-secret'
});

const {deposit_addresses} = await privy.wallets().depositAccounts.crypto.create(walletId, {
  source: {
    mode: 'include',
    values: [{asset: 'usdc', chain: 'base'}]
  },
  destination: {asset: 'pathusd', chain: 'tempo'},
  authorization_context: {user_jwts: [userJwt]}
});

Response

A successful response includes the following fields:

object[]

One entry per source route created for the destination wallet.

Hide properties

string

Address to sends funds to. If the source assets are on the same chain type as the wallet, this should be same as the wallet address.

string

ID of the source wallet behind this deposit address.

object

Assets this address accepts, using aliases when known.

Hide properties

'all' | 'include' | 'exclude'

Filter applied to this deposit address.

object[]

Accepted assets.

Hide properties

string

object

Asset and chain delivered to the destination wallet, using aliases when known.

Hide properties

string

{
  "deposit_addresses": [
    {
      "wallet_id": "insert-source-wallet-id",
      "deposit_address": "0x1234...abcd",
      "source": {
        "mode": "include",
        "values": [{"asset": "usdc", "chain": "base"}]
      },
      "destination": {"asset": "pathusd", "chain": "tempo"}
    }
  ]
}

Funding

Deposits

Payouts

Create a deposit account

Response

Next steps

Funding overview

Fiat deposits

​Response

​Next steps

Funding overview

Fiat deposits

Response

Next steps