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

# Institutional

> Admin-level registry view for browsing all vaults, operating registry workflows, and provider administration.

<img src="https://mintcdn.com/superform-cb7ef652/dryLGguJtin4LdWM/curate/images/screenshots/manage-vaults.jpg?fit=max&auto=format&n=dryLGguJtin4LdWM&q=85&s=21a6f4ab59ef29b95e50c47137a8082f" alt="SuperVaults Institutional Vaults — full registry table with chain filter, search, and Add Vault actions" width="1562" height="2000" data-path="curate/images/screenshots/manage-vaults.jpg" />

The Institutional section is the admin-level registry view, accessible from the top navigation bar. It provides a comprehensive view of all registered SuperVaults across chains, vault deployment workflows, and provider administration.

***

## Vaults

**Route:** `/manage`

The primary Institutional view is the full vault registry table. All authenticated users can browse the complete list of registered vaults.

### Registry Table

The table displays all registered SuperVaults (576+ as of March 2026) with the following columns:

| Column       | Description                                       |
| ------------ | ------------------------------------------------- |
| Name         | Vault display name                                |
| Chain        | Deployment chain (e.g., Ethereum, Base, Arbitrum) |
| Symbol       | Vault token symbol                                |
| Providers    | Number of yield source providers configured       |
| TVL          | Total value locked in USD                         |
| APY          | Current annualized percentage yield               |
| Availability | Public / Private vault status                     |
| Created      | Vault creation timestamp                          |

### Filtering and Search

* **Chain filter** — dropdown to filter vaults by deployment chain
* **Search** — search by vault name or contract address

All columns are sortable. Click a column header to sort ascending/descending.

### Actions

| Action           | Description                                                              |
| ---------------- | ------------------------------------------------------------------------ |
| **Add Vault**    | Register a new vault in the registry. Opens the vault registration flow. |
| **Add Provider** | Register a new yield source provider.                                    |

***

## My Vaults

**Route:** `/manage/my-vaults`

The vault deployment and approval queue for registry maintainers. This sub-page shows vaults you've deployed or submitted for registry inclusion, along with their approval status.

<Warning>
  My Vaults requires the `registry_maintainer` role. Users without this role will see an **Access Denied** message.
</Warning>

***

## Providers

**Route:** `/manage/providers`

Provider operations for registry maintainers, organized into two sub-tabs:

| Tab              | Description                                                |
| ---------------- | ---------------------------------------------------------- |
| **My Providers** | Providers you've registered, with edit and status controls |
| **Queue**        | Pending provider submissions awaiting approval             |

<Warning>
  The Providers sub-page requires the `registry_maintainer` role. Users without this role will see an **Access Denied** message.
</Warning>

***

## Permission Model

| Section                 | Required Role          | Description                                          |
| ----------------------- | ---------------------- | ---------------------------------------------------- |
| Vaults (registry table) | Any authenticated user | Browse and search the full vault registry            |
| My Vaults               | `registry_maintainer`  | Manage vault deployments and the approval queue      |
| Providers               | `registry_maintainer`  | Manage provider registrations and the approval queue |

***

## API Reference

Vault list data comes from `GET /api/v1/public/vaults` (unauthenticated) or `GET /api/v1/vaults` (authenticated). Yield source and oracle registry data comes from `/api/v1/registry/yield-sources` and `/api/v1/registry/oracles`.

| Endpoint                             | Method | Auth | Description                                            |
| ------------------------------------ | ------ | ---- | ------------------------------------------------------ |
| `GET /api/v1/public/vaults`          | GET    | None | Public vault list (no auth, used on Home page)         |
| `GET /api/v1/vaults`                 | GET    | JWT  | Authenticated vault list (`?detail=minimal&limit=500`) |
| `GET /api/v1/registry/yield-sources` | GET    | JWT  | List yield sources (`?chain_id={}&is_active=true`)     |
| `GET /api/v1/registry/oracles`       | GET    | JWT  | List oracles                                           |
