--- title: "Earn withdraw" method: POST path: "/v1/wallets/{wallet_id}/earn/ethereum/withdraw" tags: ["Wallet Actions"] --- # Earn withdraw `POST /v1/wallets/{wallet_id}/earn/ethereum/withdraw` Withdraw assets from an ERC-4626 vault. ## Path parameters - `wallet_id` string, required — ID of the wallet. ## Headers - `privy-app-id` string, required — ID of your Privy app. - `privy-authorization-signature` string — Request authorization signature. If multiple signatures are required, they should be comma separated. - `privy-request-expiry` string — Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed. - `privy-idempotency-key` string — Idempotency keys ensure API requests are executed only once within a 24-hour window. ## Request body - EarnWithdrawRequestBody — Input for withdrawing assets from an ERC-4626 vault. Exactly one of `amount` or `raw_amount` must be provided. - `amount` string — Human-readable decimal amount to withdraw (e.g. "1.5" for 1.5 USDC). Exactly one of `amount` or `raw_amount` must be provided. - `raw_amount` string — Amount in smallest unit to withdraw (e.g. "1500000" for 1.5 USDC with 6 decimals). Exactly one of `amount` or `raw_amount` must be provided. - `vault_id` string, required — The ID of the vault to withdraw from. ## Response `200` Earn withdraw initiated successfully. - EarnWithdrawActionResponse — Response for an earn withdraw action. - `amount` string — Human-readable decimal amount of asset withdrawn (e.g. "1.5"). Only present when the token is known in the asset registry. - `asset` string — Asset identifier (e.g. "usdc", "eth"). Only present when the token is known in the asset registry. - `asset_address` string, required — Underlying asset token address. - `caip2` string, required — CAIP-2 chain identifier. - `created_at` string, date-time, required — ISO 8601 timestamp of when the wallet action was created. - `decimals` integer — Number of decimals for the underlying asset (e.g. 6 for USDC, 18 for ETH). Only present when the token is known in the asset registry. - `failure_reason` object — Top-level failure context for the wallet action. Present on rejected or failed actions when available. - `details` unknown - `message` string, required — Human-readable failure message. - `id` string, required — The ID of the wallet action. - `raw_amount` string, required — Base-unit amount of asset withdrawn (e.g. "1500000"). - `share_amount` string, nullable, required — Vault shares burned in base units. Populated after on-chain confirmation. - `status` 'pending' | 'succeeded' | 'rejected' | 'failed', required — The current status of the wallet action. - `steps` WalletActionStep[] — The steps of the wallet action. Only returned if `?include=steps` is provided. - union — A step within a wallet action, representing a single onchain action. - object — A wallet action step consisting of an EVM transaction. - `caip2` string, required — CAIP-2 chain identifier of the transaction, containing the chain ID. - `failure_reason` FailureReason — A description of why a wallet action (or a step within a wallet action) failed. - `details` unknown - `message` string, required — Human-readable failure message. - `finalized` boolean — Whether this step has reached on-chain finality. Absent until finality is confirmed. - `status` 'preparing' | 'queued' | 'pending' | 'retrying' | 'confirmed' | 'rejected' | 'reverted' | 'replaced' | 'abandoned', required — EVM transaction status. - `transaction_hash` string, nullable, required — The transaction hash for this step. May change while the step status is non-terminal. - `type` 'evm_transaction', required - object — A wallet action step consisting of an EVM user operation. - `bundle_transaction_hash` string, nullable, required — Transaction hash of the bundle in which this user operation was included. Null until included by a bundler. - `caip2` string, required — CAIP-2 network identifier, containing the chain ID of the user operation. - `entrypoint_version` '0.6' | '0.7' | '0.8' | '0.9', required — The entrypoint version of the user operation. - `failure_reason` FailureReason — A description of why a wallet action (or a step within a wallet action) failed. - `details` unknown - `message` string, required — Human-readable failure message. - `finalized` boolean — Whether this step has reached on-chain finality. Absent until finality is confirmed. - `gas_credits_charged_usd` string — Amount charged in USD for gas sponsorship on this step. - `status` 'preparing' | 'queued' | 'pending' | 'retrying' | 'confirmed' | 'rejected' | 'reverted' | 'replaced' | 'abandoned', required — User operation status. - `type` 'evm_user_operation', required - `user_operation_hash` string, nullable, required — The user operation hash for this step. May change while the step status is non-terminal. - object — A wallet action step consisting of an SVM (Solana) transaction. - `caip2` string, required — CAIP-2 chain identifier for the Solana network. - `failure_reason` FailureReason — A description of why a wallet action (or a step within a wallet action) failed. - `details` unknown - `message` string, required — Human-readable failure message. - `finalized` boolean — Whether this step has reached on-chain finality. Absent until finality is confirmed. - `gas_credits_charged_usd` string — Amount charged in USD for gas sponsorship on this step. - `status` 'preparing' | 'queued' | 'pending' | 'confirmed' | 'rejected' | 'reverted' | 'failed', required — SVM transaction status. - `transaction_signature` string, nullable, required — The Solana transaction signature (base58-encoded). Null until broadcast. - `type` 'svm_transaction', required - object — A wallet action step consisting of a TVM (Tron) transaction. - `caip2` string, required — CAIP-2 chain identifier for the Tron network. - `failure_reason` FailureReason — A description of why a wallet action (or a step within a wallet action) failed. - `details` unknown - `message` string, required — Human-readable failure message. - `status` 'preparing' | 'queued' | 'pending' | 'confirmed' | 'rejected' | 'reverted' | 'failed', required — TVM transaction status. - `transaction_id` string, nullable, required — The Tron transaction ID. Null until broadcast. - `type` 'tvm_transaction', required - object — A wallet action step representing a cross-chain/cross-asset fill by an external provider. - `failure_reason` FailureReason — A description of why a wallet action (or a step within a wallet action) failed. - `details` unknown - `message` string, required — Human-readable failure message. - `status` 'preparing' | 'queued' | 'pending' | 'confirmed' | 'rejected' | 'failed', required — External transaction step status. - `type` 'external_transaction', required - object — A wallet action step representing a transaction executed by a custodian (e.g. Bridge). - `custodian` string, required — Identifier of the custodian executing this transaction (e.g. "bridge"). - `failure_reason` FailureReason — A description of why a wallet action (or a step within a wallet action) failed. - `details` unknown - `message` string, required — Human-readable failure message. - `status` 'preparing' | 'queued' | 'custodian_reviewing' | 'pending' | 'confirmed' | 'rejected' | 'failed', required — Custodian transaction step status. - `type` 'custodian_transaction', required - `type` 'earn_withdraw', required - `vault_address` string, required — ERC-4626 vault contract address. - `vault_id` string, required — The vault ID. - `wallet_id` string, required — The ID of the wallet involved in the action. --- [API](https://skmtc.net/privy-io/apis/privy-api.md) · [All operations](https://skmtc.net/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)