Sending funds

Custodial wallets support transferring assets using the /transfer endpoint — the same interface used by non-custodial wallets. This provides a simple, chain-agnostic way to move funds without needing to encode raw transaction data.

All transactions from custodial wallets are executed server-side.

Initiate a transfer

For custodial wallets, only assets that are supported by the custodian can be transferred. Supported assets: USDC, USDB, EURC Supported chains: Base, Solana

Like non-custodial wallets, custodial wallets with an owner or additional_signers require an authorization signature for transaction requests.

Usage

Make a POST request to /v1/wallets/{wallet_id}/transfer with the source asset, amount, chain, and destination address:

Node.js SDK
REST API

const transfer = await privy.wallets().transfer('insert-wallet-id', {
  amount: '10.0',
  source: {
    asset: 'usdc',
    chain: 'base',
  },
  destination: {
    address: '0xRecipientAddress...',
  },
});

console.log(transfer.id);     // wallet action ID
console.log(transfer.status); // 'pending'

curl -X POST https://api.privy.io/v1/wallets/{wallet_id}/transfer \
  -H "Content-Type: application/json" \
  -H "privy-app-id: YOUR_APP_ID" \
  -H "Authorization: Basic BASE64_ENCODED_APP_SECRET" \
  -d '{
    "source": {
      "asset": "usdc",
      "amount": "10.0",
      "chain": "base"
    },
    "destination": {
      "address": "0xRecipientAddress..."
    }
  }'

Parameters

string

required

The ID of the custodial wallet to send the transfer from.

object

required

The source asset, amount, and chain for the transfer.

Hide properties

string

required

The asset to transfer (e.g. "usdc", "usdb", "eurc").

string

required

The amount to transfer as a decimal string in standard units (e.g. "10.0" for 10 USDC). No need to convert to smallest units.

string

required

The chain to transfer from (e.g. "base" or "solana").

object

required

The destination for the transfer.

Hide properties

string

required

The recipient wallet address. Use a hex address for EVM chains and a base58 address for Solana.

Returns

The response is a wallet action object with type: "transfer":

string

The wallet action ID. Use this to poll for status updates via GET /v1/wallets/{wallet_id} /actions/{action_id}.

string

The action status: pending, succeeded, rejected, or failed.

'transfer'

The action type.

string

The asset being transferred.

string

The amount being transferred in standard units.

string

The source chain.

string

The recipient address.

Next steps

Transfer lifecycle

Learn about the transfer lifecycle for custodial wallets

Sending USDC recipe

Learn how to format and encode ERC-20 token transfers

Authorization controls

Configure policies and multi-party approvals for custodial wallets

Transfer webhooks

Monitor transfer status and lifecycle events

Embedded wallets

Management

Usage

UI components

Custodial wallets

Global wallets

EVM smart wallets

Initiate a transfer

Usage

Parameters

Returns

Next steps

Transfer lifecycle

Sending USDC recipe

Authorization controls

Transfer webhooks

​Initiate a transfer

​Usage

​Parameters

​Returns

​Next steps

Transfer lifecycle

Sending USDC recipe

Authorization controls

Transfer webhooks

Initiate a transfer

Usage

Parameters

Returns

Next steps