> ## 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.

# Request a Meta Vault

> Configure a Meta Vault from the yield.xyz dashboard, submit the request, and track it through to a live yield ID.

Request and manage [Meta Vaults](/documentation/platform/vaults/meta-vaults/index) (multi-strategy [OAVs](/documentation/platform/vaults/index)) from the **Allocator Vaults** table on your project page in the [yield.xyz dashboard](https://dashboard.yield.xyz). You choose the strategies, weights, and fees; yield.xyz deploys the vault on-chain and enables it as a yield ID for your project. This section only appears for teams with OAVs enabled; contact yield.xyz if you don't see it.

## Configure a Meta Vault

<Steps>
  <Step title="Start a request">
    On your project page, go to **Allocator Vaults** and click **Create OAV** (or **Create your first OAV** if none exist yet).

    <Frame caption="The Allocator Vaults table before any vault has been requested">
      <img src="https://mintcdn.com/yieldxyz/5O6VGCUJ53mQMtrB/images/documentation/oavs/meta-vault-dashboard-add-oav.png?fit=max&auto=format&n=5O6VGCUJ53mQMtrB&q=85&s=2628bfdbd512f1a5c239fa78652b4b69" alt="Allocator Vaults table in the yield.xyz dashboard with the Create OAV button" width="2844" height="1524" data-path="images/documentation/oavs/meta-vault-dashboard-add-oav.png" />
    </Frame>
  </Step>

  <Step title="Select network and deposit token">
    Choose a **Network** and a deposit **Token** from the tokens available to your project. This selection scopes which yields you can add as strategies in the next step.

    <Frame caption="Selecting the network and deposit token for a new Meta Vault">
      <img src="https://mintcdn.com/yieldxyz/5O6VGCUJ53mQMtrB/images/documentation/oavs/meta-vault-strategy-selection.png?fit=max&auto=format&n=5O6VGCUJ53mQMtrB&q=85&s=dbef783dde533c5b759cf780c6e82814" alt="Network and token selection in the OAV creation modal" width="2844" height="1524" data-path="images/documentation/oavs/meta-vault-strategy-selection.png" />
    </Frame>
  </Step>

  <Step title="Select strategies and set weights">
    Search **Find Yield** and check up to 5 yields to include as strategies. Each time you add or remove a yield, the dashboard redistributes weights equally across the selected yields.

    To set custom weights, turn off **Optimization mode** and edit the weight field next to each yield; the total must equal 100% before you can continue. With **Optimization mode** on, weight inputs are hidden and the optimization engine rebalances the vault toward the highest APY instead.

    <Frame caption="Selected yields with weights, before submitting the request">
      <img src="https://mintcdn.com/yieldxyz/5O6VGCUJ53mQMtrB/images/documentation/oavs/meta-vault-strategy-selected.png?fit=max&auto=format&n=5O6VGCUJ53mQMtrB&q=85&s=503b2b683dccdb408d048761002a216f" alt="Selected yields and their weights in the OAV creation modal, with the optimization mode switch" width="2844" height="1524" data-path="images/documentation/oavs/meta-vault-strategy-selected.png" />
    </Frame>

    Click **Next**.
  </Step>

  <Step title="Name the vault and set fees">
    Set the **OAV name**, then enter the fee inputs the form supports: **Management Fee (in BPS)**, **Performance Fee (in BPS)**, and **Deposit Fee (in BPS)**, each from 1 to 5,000 bps. Click **Create** to submit the request.

    <Frame caption="Naming the Meta Vault and setting its fee inputs">
      <img src="https://mintcdn.com/yieldxyz/5O6VGCUJ53mQMtrB/images/documentation/oavs/meta-vault-fee-configuration.png?fit=max&auto=format&n=5O6VGCUJ53mQMtrB&q=85&s=5f1049f3a386b0ab076642c07cb7864d" alt="OAV configuration step with fields for the name and management, performance, and deposit fee inputs in basis points" width="2844" height="1524" data-path="images/documentation/oavs/meta-vault-fee-configuration.png" />
    </Frame>

    <Note>
      The dashboard form accepts up to 5,000 bps per fee, but the on-chain vault contract bounds what can actually be applied, and performance fees above 2,000 bps (20%) are never charged. Agree your target fee levels with yield.xyz before submitting; see [Monetization](/documentation/earn/monetization).
    </Note>
  </Step>
</Steps>

## What happens after you submit

Submitting the form creates a request with status **REQUESTED**, holding your selected strategies, weights, optimization mode, fee inputs, network, and deposit token.

<Frame caption="A submitted OAV request">
  <img src="https://mintcdn.com/yieldxyz/5O6VGCUJ53mQMtrB/images/documentation/oavs/meta-vault-request-submitted.png?fit=max&auto=format&n=5O6VGCUJ53mQMtrB&q=85&s=7585e67939e1b2c1afd835e807b317b8" alt="Allocator Vaults table showing a request with REQUESTED status" width="1995" height="1062" data-path="images/documentation/oavs/meta-vault-request-submitted.png" />
</Frame>

This part is yield.xyz-assisted, not self-service: yield.xyz deploys the on-chain vault, sets its roles, and enables it as a yield ID scoped to your project. Once deployed, the request's status becomes **LIVE**.

## Monitor status

Track a vault's status, optimization mode, fees, and aggregate APY directly in the **Allocator Vaults** table:

| Column | Shows |
| - | - |
| Name | The OAV name you set |
| Integration ID | The yield ID once the vault is live |
| Status | `REQUESTED`, `LIVE`, or `CHANGES REQUESTED` |
| Optimization | `Auto` (optimization mode on) or `Manual` |
| Fees | Performance, management, and deposit fees, each shown as a percentage |
| APY | The vault's aggregate APY across its strategies |

<Frame caption="A live Meta Vault in the Allocator Vaults table">
  <img src="https://mintcdn.com/yieldxyz/5O6VGCUJ53mQMtrB/images/documentation/oavs/meta-vault-live-status.png?fit=max&auto=format&n=5O6VGCUJ53mQMtrB&q=85&s=d0e45ba35a75134eb1e269a138384b01" alt="Allocator Vaults table row for a live Meta Vault with its status, optimization mode, fees, and APY" width="2844" height="1524" data-path="images/documentation/oavs/meta-vault-live-status.png" />
</Frame>

Once a vault is `LIVE`, its yield ID appears in `GET /v1/yields` for your project like any other enabled yield; see [Discover yields](/guides/earn/discover-yields).

## Edit an existing Meta Vault

Open the row's action menu and select **Edit OAV** to change, subject to yield.xyz review:

* The strategy list (add or remove yields, up to 5)
* Target weights (editable when optimization mode is off)
* The optimization mode toggle
* Fees (management, performance, deposit)
* Whether the vault is active

Submitting changes sets the request back to a pending state for yield.xyz to apply; the table's **Status** column reflects the current state.

## Next steps

<Columns cols={2}>
  <Card title="Meta Vaults" icon="vault" href="/documentation/platform/vaults/meta-vaults/index">
    What a Meta Vault is and how allocation across strategies works.
  </Card>

  <Card title="Allocation and rebalancing" icon="scale-balanced" href="/documentation/platform/vaults/meta-vaults/vault-mechanics/allocation-weights-rebalancing">
    What happens on-chain when weights change.
  </Card>

  <Card title="Monetization" icon="percent" href="/documentation/earn/monetization">
    How each fee type is charged.
  </Card>

  <Card title="Discover yields" icon="magnifying-glass" href="/guides/earn/discover-yields">
    Find a live Meta Vault's yield ID once it appears in the catalog.
  </Card>
</Columns>


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