> ## Documentation Index
> Fetch the complete documentation index at: https://yieldxyz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Discretionary fees

> Configure Earn fees per yield integration and Trade builder fees per provider from the dashboard's Fee configuration section.

The dashboard's **Fee configuration** section has two tabs: **Yield**, for fees on individual Earn integrations, and **Trade**, for the Hyperliquid builder fee. Both are configured per project.

<Warning>
  Add a [payout wallet](/documentation/advanced-setup/dashboard/payout-wallets) before requesting a Yield tab fee configuration. yield.xyz sets the fee recipient from it when the configuration goes live. Trade builder fees use a builder address instead, described in the Trade tab section.
</Warning>

## Yield tab

Select an enabled yield, then set the fee amounts it supports. Which fee fields appear depends on the yield's metadata: a yield only shows the deposit, management, or performance fee inputs it actually supports.

| Fee | Range |
| - | - |
| Deposit fee | 1 to 5,000 bps |
| Management fee | 1 to 5,000 bps |
| Performance fee | 1 to 5,000 bps |

<Warning>
  Performance fees above 2,000 bps (20%) are never charged, even if the form accepts a higher value. Set performance fees at or below 2,000 bps.
</Warning>

Requesting a fee moves it through a lifecycle:

| Status | Meaning |
| - | - |
| `REQUESTED` | Submitted; yield.xyz deploys the fee contracts |
| `PROCESSING` | Deployment in progress |
| `LIVE` | Applied: transactions on the project's API keys route through the fee contracts |

Only a `LIVE` configuration is applied. Confirm changes to a live configuration with yield.xyz.

<Note>
  Optimized Allocator Vault fees are set when you request the OAV (see the [dashboard guide](/guides/dashboards/meta-vaults)), not here, and are also bounded by the vault contract, so agree OAV fee levels with yield.xyz. Morpho Blue borrow wrapper fees are configured with the yield.xyz team, not in the dashboard; see [Borrow monetization](/documentation/borrow/monetization).
</Note>

## Trade tab

The Trade tab configures the Hyperliquid builder fee, and only appears for a Trade provider that has the **Perps Fee Config** feature enabled.

| Field | Range / rule |
| - | - |
| Builder fee | 1 to 10 bps |
| Builder address | Optional on input; yield.xyz sets or confirms it as part of configuration before the configuration goes `LIVE` |

A configuration can only reach `LIVE` once it has both a fee and a builder address confirmed by yield.xyz, and the address must hold at least 100 USDC in its Hyperliquid account before builder codes activate.

| Status | Meaning |
| - | - |
| `REQUESTED` | Submitted, awaiting address confirmation |
| `LIVE` | Applied: the configured builder fee applies once the configuration is live |
| `DISABLED` | Not applied |

<Note>
  The Trade fee model is described in [Trade monetization](/documentation/trade/monetization).
</Note>

## Who can manage fees

Requesting, updating, or deleting a fee configuration (Yield or Trade) requires the **owner**, **admin**, or **operator** role. All roles can view fee configurations.

## Programmatic alternative

Fee configurations can also be created and updated through an Admin API key; see [Programmatic access](/documentation/advanced-setup/programmatic-access).

## Next steps

<CardGroup cols={2}>
  <Card title="Payout wallets" icon="wallet" href="/documentation/advanced-setup/dashboard/payout-wallets">
    Where your collected fees get deposited.
  </Card>

  <Card title="Monetization" icon="hand-holding-dollar" href="/documentation/earn/monetization">
    Earn fee types and how they're enforced.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.