Setting up earn

Deploy a fee wrapper and configure your vault in the Privy Dashboard.

Your app configures earn settings from the Privy Dashboard, under Wallet infrastructure > Earn. There are two ways to get a vault: deploy one yourself, or have Privy deploy one for you.

Prerequisites

• A Privy app with embedded wallets configured
• API credentials (your app ID and app secret)
• A webhook endpoint registered in the Privy Dashboard (recommended)

Deploy a vault yourself

Open the Wallet infrastructure > Earn page in the Privy Dashboard and configure a fee wrapper. During setup, your app selects:

1. A Morpho vault to allocate assets into
2. The percentage of generated yield your app receives
3. An admin wallet to claim fees and manage the vault configuration

Do your own research when selecting a vault. You can find more information on the vaults supported in the Dashboard, including details on the liquidity and allocation below:

• Sentora PathUSD (PathUSD on Tempo)
• Gauntlet USDC Prime (USDC on Base)
• Steakhouse Prime Instant (USDC on Base)

Using an external wallet as an admin wallet (advanced)

The admin wallet must sign onchain transactions to manage the vault and claim fees. Exchange wallets, cold storage, and other non-signing wallets do not work. Privy cannot reassign the admin wallet after creation.

Updating the fee wrapper configuration (advanced)

Privy assigns all fee wrapper roles to the admin wallet. Developers can update fee wrapper configurations in the future. Learn more about fee wrapper roles here. Contact [e-mail] to change the fee wrapper configuration.

Privy-generated admin wallets have no owner by default, and your app secret alone authorizes them. Assign an authorization key to require a second factor. See the security checklist for more details.

Reach out to Privy for other vaults

Contact [e-mail] to enable any Aave, Veda, or Morpho vault not shown in the self-serve setup flow in the Privy Dashboard. These vaults will appear in the Dashboard. See the Aave and Veda integration guides for more information.

Copy the vault ID

After setup, Privy provides a unique vault_id for the vault. Copy this value — all deposit and withdraw API calls require it.

To verify the vault is live, query its details with the get vault details endpoint:

curl https://api.privy.io/api/v1/earn/ethereum/vaults/{vault_id} \
  -H "privy-app-id: <your-app-id>" \
  -H "Authorization: Basic <credentials>"

The earn API is provider- and chain-agnostic: your app passes a vault_id and uses the same endpoints for every vault. Privy namespaces EVM endpoints under /earn/ethereum/..., which applies to vaults on any supported EVM chain — not just Ethereum mainnet. Privy routes each request to the vault’s configured chain.

Next steps

Deposit funds

Deposit assets from a wallet into a yield vault.

Privy does not control DeFi vaults or underlying protocols. Vault information is provided for reference only and may change or be inaccurate. Earnings are generated from third-party vaults and are not guaranteed. Using vaults involves risk, including loss of funds. These materials are for general information purposes only and are not investment advice or a recommendation or solicitation to engage in any specific transaction. You are responsible for evaluating vaults at your own discretion. Privy does not provide investment, financial, legal, or tax advice.