Earn withdraw
curl --request POST \
--url https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/withdraw \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: <privy-app-id>' \
--data '
{
"vault_id": "cm7oxq1el000e11o8iwp7d0d0",
"amount": "1.5"
}
'HttpResponse<String> response = Unirest.post("https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/withdraw")
.header("privy-app-id", "<privy-app-id>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"vault_id\": \"cm7oxq1el000e11o8iwp7d0d0\",\n \"amount\": \"1.5\"\n}")
.asString();const options = {
method: 'POST',
headers: {
'privy-app-id': '<privy-app-id>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({vault_id: 'cm7oxq1el000e11o8iwp7d0d0', amount: '1.5'})
};
fetch('https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/withdraw', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/withdraw",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'vault_id' => 'cm7oxq1el000e11o8iwp7d0d0',
'amount' => '1.5'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json",
"privy-app-id: <privy-app-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/withdraw"
payload := strings.NewReader("{\n \"vault_id\": \"cm7oxq1el000e11o8iwp7d0d0\",\n \"amount\": \"1.5\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("privy-app-id", "<privy-app-id>")
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "pending",
"wallet_id": "fmfdj6yqly31huorjqzq38zc",
"created_at": "2026-01-15T12:00:00.000Z",
"type": "earn_withdraw",
"caip2": "eip155:8453",
"vault_id": "cm7oxq1el000e11o8iwp7d0d0",
"vault_address": "0x1234567890abcdef1234567890abcdef12345678",
"asset": "usdc",
"asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"decimals": 6,
"amount": "1.5",
"raw_amount": "1500000",
"share_amount": null
}Earn
Withdraw from vault
Withdraw assets from an ERC-4626 yield vault.
POST
/
v1
/
wallets
/
{wallet_id}
/
earn
/
ethereum
/
withdraw
Earn withdraw
curl --request POST \
--url https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/withdraw \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: <privy-app-id>' \
--data '
{
"vault_id": "cm7oxq1el000e11o8iwp7d0d0",
"amount": "1.5"
}
'HttpResponse<String> response = Unirest.post("https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/withdraw")
.header("privy-app-id", "<privy-app-id>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"vault_id\": \"cm7oxq1el000e11o8iwp7d0d0\",\n \"amount\": \"1.5\"\n}")
.asString();const options = {
method: 'POST',
headers: {
'privy-app-id': '<privy-app-id>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({vault_id: 'cm7oxq1el000e11o8iwp7d0d0', amount: '1.5'})
};
fetch('https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/withdraw', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/withdraw",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'vault_id' => 'cm7oxq1el000e11o8iwp7d0d0',
'amount' => '1.5'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json",
"privy-app-id: <privy-app-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/withdraw"
payload := strings.NewReader("{\n \"vault_id\": \"cm7oxq1el000e11o8iwp7d0d0\",\n \"amount\": \"1.5\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("privy-app-id", "<privy-app-id>")
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "pending",
"wallet_id": "fmfdj6yqly31huorjqzq38zc",
"created_at": "2026-01-15T12:00:00.000Z",
"type": "earn_withdraw",
"caip2": "eip155:8453",
"vault_id": "cm7oxq1el000e11o8iwp7d0d0",
"vault_address": "0x1234567890abcdef1234567890abcdef12345678",
"asset": "usdc",
"asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"decimals": 6,
"amount": "1.5",
"raw_amount": "1500000",
"share_amount": null
}If your app has gas sponsorship configured, usage of the
/earn/ethereum/withdraw endpoint will
be gas-sponsored by default. There is no need to
specify additional parameters for sponsorship.Idempotency on errors: This endpoint returns
pending immediately. Replaying the same key
returns the cached response. On a synchronous 5xx, Privy deletes the record so the same key
retries fresh. Action outcomes (rejected, failed, succeeded) arrive via
webhooks and polling. Policy violations
always allow fresh retries.Authorizations
Headers
Body
application/json
Input for withdrawing assets from an ERC-4626 vault. Exactly one of amount or raw_amount must be provided.
Response
200 - application/json
Earn withdraw initiated successfully.
Response for an earn withdraw action.
steps
(EVMTransactionWalletActionStep · object | EVMUserOperationWalletActionStep · object | SVMTransactionWalletActionStep · object | TVMTransactionWalletActionStep · object | ExternalTransactionWalletActionStep · object | CustodianTransactionWalletActionStep · object | TempoZoneSettlementWalletActionStep · object | WisdomTreeSettlementWalletActionStep · object)[]
The steps of the wallet action. Only returned if ?include=steps is provided.
A wallet action step consisting of an EVM transaction.
- EVMTransactionWalletActionStep
- EVMUserOperationWalletActionStep
- SVMTransactionWalletActionStep
- TVMTransactionWalletActionStep
- ExternalTransactionWalletActionStep
- CustodianTransactionWalletActionStep
- TempoZoneSettlementWalletActionStep
- WisdomTreeSettlementWalletActionStep
Show child attributes
Show child attributes
Was this page helpful?

