Transfer funds

Propose an intent to transfer funds from a wallet to a destination address.

Intents expire 72 hours after creation by default. Signers must authorize them within this window.

The examples below transfer OUSD on Tempo (chain ID 4217) using the ousd asset alias.

REST API

curl -X POST https://api.privy.io/v1/intents/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": "ousd",
      "amount": "10.0",
      "chain": "tempo"
    },
    "destination": {
      "address": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2"
    }
  }'

Node SDK

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

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

const transfer: IntentTransferParams = {
  source: {
    asset: 'ousd',
    amount: '10.0',
    chain: 'tempo'
  },
  destination: {
    address: '0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2'
  }
};

const intent = await client.intents().transfer('insert-wallet-id', transfer);

console.log(intent.intent_id, intent.status, intent.authorization_details);

Ruby SDK

require "privy"

client = Privy::PrivyClient.new(
  app_id: "your-app-id",
  app_secret: "your-app-secret"
)

intent = client.intents.transfer(
  "wallet-id",
  source: {
    asset: "ousd",
    amount: "10.0",
    chain: "tempo"
  },
  destination: {
    address: "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2"
  }
)

puts(intent.intent_id, intent.status, intent.authorization_details)

Java SDK

import io.privy.api.PrivyClient;
import io.privy.api.models.components.*;
import io.privy.api.models.operations.IntentTransferResponse;

PrivyClient client = PrivyClient.builder()
    .appId("your-privy-app-id")
    .appSecret("your-app-secret")
    .build();

IntentTransferResponse intent = client.intents().transfer(
    "insert-wallet-id",
    TransferRequestBody.builder()
        .source(TokenTransferSource.of(NamedTokenTransferSource.builder()
            .asset("ousd")
            .amount("10.0")
            .chain("tempo")
            .build()))
        .destination(TokenTransferDestination.builder()
            .address("0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2")
            .build())
        .build(),
    null);

Python SDK

intent = client.intents.transfer(
    wallet_id,
    intent_transfer_params={
        "amount": "10.0",
        "source": {
            "asset": "ousd",
            "chain": "tempo",
        },
        "destination": {"address": "insert-recipient-address"},
    },
)

From the response, note the returned intent_id. Use this ID to sign the intent, check approval progress, and retrieve execution results.

View the API reference for submitting a transfer intent.

Next steps

Sign intents

Add authorization signatures to execute a proposed intent.

Intent status

Track an intent from proposal to execution.