Transfer

The transfer wallet action API sends tokens from a Privy wallet to a destination address. Instead of constructing blockchain transactions from scratch, the transfer action accepts a human-readable asset, amount, chain, and destination address — Privy handles the onchain complexity.

If your app has gas sponsorship configured, usage of the /transfer endpoint will be gas-sponsored by default. There is no need to specify additional parameters for sponsorship.

Supported assets

The /transfer API supports the following assets:

Asset	API value
USDC	`usdc`
USDC.e	`usdc_e`
USDT	`usdt`
USDT0	`usdt0`
USDB	`usdb`
EURC	`eurc`
ETH	`eth`
SOL	`sol`
POL	`pol`

Supported chains

The /transfer API supports the following chains:

Chain	CAIP-2	API value
Ethereum	`eip155:1`	`ethereum`
Base	`eip155:8453`	`base`
Arbitrum	`eip155:42161`	`arbitrum`
Polygon	`eip155:137`	`polygon`
Tempo	`eip155:4217`	`tempo`
Solana	`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`	`solana`
Ethereum Sepolia	`eip155:11155111`	`ethereum_sepolia`
Base Sepolia	`eip155:84532`	`base_sepolia`
Arbitrum Sepolia	`eip155:421614`	`arbitrum_sepolia`
Polygon Amoy	`eip155:80002`	`polygon_amoy`
Tempo Moderato	`eip155:42431`	`tempo_moderato`
Solana Devnet	`solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1`	`solana_devnet`

To transfer assets or chains not listed above, use the low-level RPC API to construct and send transactions directly.

Usage

To execute a transfer, make a POST request to /v1/wallets/{wallet_id}/transfer.

Body

source

object

required

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

Hide properties

source.asset

string

required

The asset to transfer. Must be one of usdc, usdc_e, usdt, usdt0, usdb, eth, sol, pol, or eurc.

source.amount

string

required

The amount of tokens to transfer, as a decimal string in standard units (e.g. "10.0" for 10 USDC). The API handles decimal precision based on the asset — most stablecoins like USDC use 6 decimal places, while native tokens like ETH use 18 and SOL uses 9. There is no need to convert to the smallest unit (e.g. wei, lamports, or micro-units) before sending the request.

source.chain

string

required

The chain to transfer from. Must be one of ethereum, base, arbitrum, polygon, tempo, or solana.

destination

object

required

The destination for the transfer.

Hide properties

destination.address

string

required

The recipient wallet address.

Response

The endpoint returns a 200 response with a pending wallet action resource.

The transfer action is processed asynchronously. The response contains a pending wallet action resource with status: "pending" that Privy processes in the background.

string

The unique identifier for the wallet action.

status

'pending' | 'completed' | 'failed'

The current status of the action.

wallet_id

string

The ID of the wallet initiating the transfer.

created_at

string

The ISO 8601 timestamp for when the action was created.

type

'transfer'

The type of action. For transfers, this is always transfer.

source_asset

string

The asset being transferred.

source_amount

string

The amount of the asset being transferred, as a decimal string.

source_chain

string

The chain the transfer is sent from.

destination_address

string

The recipient wallet address.

To track the status of a transfer, see wallet action lifecycle.

Example

Node SDK
REST API

Use the transfer convenience method on the wallets service to transfer tokens from a wallet.

const response = await privy.wallets().transfer('insert-wallet-id', {
  source: {
    asset: 'usdc',
    amount: '10.0',
    chain: 'base',
  },
  destination: {
    address: '0xRecipientAddress',
  },
  authorization_context: {
    authorization_private_keys: ['<authorization-private-key>'],
  },
});

The method returns a TransferActionResponse with the pending wallet action. See wallet action lifecycle to track the status.

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

Example response

{
  "id": "action-id",
  "status": "pending",
  "wallet_id": "wallet-id",
  "created_at": "2026-04-14T20:09:11.929Z",
  "type": "transfer",
  "source_asset": "usdc",
  "source_amount": "10.0",
  "source_chain": "base",
  "destination_address": "0xRecipientAddress"
}

API reference

See the API reference for more details.

Wallet actions

Swap

Earn

Transfer

Usage

Body

Response

Example

API reference

Wallet actions

Transfer

Swap

Earn

Documentation Index

​Usage

​Body

​Response

​Example

​API reference

Usage

Body

Response

Example

API reference