Skip to main content

Documentation Index

Fetch the complete documentation index at: https://yieldxyz.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Yield.xyz enables partners to monetize staking and DeFi yields through flexible, modular fee structures. Fees are enforced through audited smart contracts and can be configured at the integration or product level.

Immediate monetization

Deposit fees capture value at entry

Ongoing revenue

Performance and management fees generate recurring income

Full composability

Deposit fees preserve DeFi composability with protocol-native tokens

Audited infrastructure

FeeWrapper and Allocator Vault contracts are independently audited

Fee Types

One-time fee at entryCharged when users deposit into a yield. Deducted before funds enter the protocol.
AttributeValue
Typical range0.2% – 0.8% (up to 2% in some cases)
When chargedAt deposit
DeFi composabilityYes — users receive protocol-native receipt tokens
Monetization timingImmediate

How Fees Are Applied

Deposit Fees

FeeWrapper smart contracts deduct the configured fee and deposit the remainder into the protocol — all in a single atomic transaction.
  • Partners configure deposit contracts, tokens, fee percentages, and recipients
  • Users receive protocol-native receipt tokens (stETH, aUSDC, etc.)
  • Full DeFi composability preserved
Atomic fee transfer mechanisms append custom instructions to the staking transaction. Fee deduction and deposit occur simultaneously.
Fee is collected via a separate transaction that the user must sign before staking. This is the only chain where fee collection is not atomic.
Non-atomic fee collection on Tron requires an additional user signature and introduces slight friction.

Performance & Management Fees

Both fee types are applied through Allocator Vaults — ERC-4626-compliant smart contracts:
  1. At harvest, the vault calculates realized profits (performance fee) and elapsed time (management fee)
  2. New vault tokens are minted and allocated to fee recipients
  3. Users are only charged on yield — principal is preserved
The computedRewardRate field in API responses reflects net APY after performance fees, providing transparent yield expectations.

Fee Examples by Product

Staking (StakeKit)

Fee TypeTypical RangeTiming
Deposit Fee0 – 1%One-time
Validator Revenue Share50 – 85%Ongoing

DeFi (DeFiKit via OAVs)

Fee TypeTypical RangeTiming
Deposit Fee0 – 2%One-time
Performance Fee5 – 20%On rewards
Management Fee0.5 – 2%Annual

Optimized Allocator Vaults (OAVs)

OAVs are pre-configured DeFi vaults with preset fee structures:
Set ID: 4bea9274-7cef-4e43-995b-f35147469ede
  • 10% performance fee on realized profits
  • Automatic reward reinvestment
  • Multiple underlying yield strategies
Fee configurations are queryable on-chain and through the API. Learn more about OAVs.

Payout Wallets

Fees are sent directly on-chain to configured payout wallet addresses. Configure one address per network:
{
  "payoutWallets": {
    "ethereum": "0x1234567890abcdef...",
    "base": "0xabcdef1234567890...",
    "cosmos": "cosmos1abc123..."
  }
}
Ensure you control the payout wallet addresses. Fees are transferred on-chain and cannot be recovered if sent to an incorrect address.

Configuration

Fees are configurable via dashboard or API:
1

Navigate to Fees

Go to Settings → Fees in the Yield.xyz Dashboard
2

Select fee types

Enable deposit, performance, and/or management fees
3

Set percentages

Configure rates globally or per-yield
4

Configure payout wallets

Set receiving addresses for each network

Security & Audits

FeeWrapper Audit

Audited by Zellic. No custody of user funds — only configuration control.View Audit Report →

Allocator Vault Audit

Latest Cantina audit: 0 critical, high, or medium issues.Request security review details from your account team.

Best Practices

Competitive rates

Research market rates before setting fees

Transparent disclosure

Clearly communicate fee structures to users

Test in staging

Verify fee logic before production deployment

Monitor payouts

Track fee collection and payout flows regularly

Next Steps

Plans & Pricing

View plan options and pricing tiers

Contact Us

Get help with fee configuration