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

# List Vaults

> List all vaults and optionally include the querying account's share balance.

```http theme={null}
GET /api/v1/lake/list
```

Returns all vaults ordered by creation time descending. If `account` is provided, the response also includes that account's share balance in each vault as `user_share`.

#### Query Parameters

<table><thead><tr><th width="176">Field</th><th width="98">Type</th><th width="95">Need</th><th width="200">Description</th><th>Example</th></tr></thead><tbody><tr><td><code>"account"</code></td><td>string</td><td>optional</td><td>Account address whose share balance should be included</td><td><code>42trU9A5...</code></td></tr></tbody></table>

```http theme={null}
/api/v1/lake/list?account=42trU9A5...
```

#### Response

* Status 200: List of vaults

```json theme={null}
{
  "success": true,
  "data": {
    "lakes": [
      {
        "address": "AbCdEfGh123456789...",
        "creator": "42trU9A5...",
        "manager": "8zFqj1Kp...",
        "nickname": "BTC Basis Vault",
        "lp_shares": "900000.00",
        "manager_shares": "100000.00",
        "lp_balance": "910000.00",
        "manager_balance": "115000.00",
        "last_checked_equity": "1025000.00",
        "high_watermark": "1025000.00",
        "created_at": 1700000000000,
        "referrer": "7xyReferrer...",
        "user_share": "500.00",
        "config": {
          "deposit_cap": "1000000.00",
          "manager_profit_share": "0.20",
          "manager_loss_share": "0",
          "deposit_min_duration_ms": 86400000,
          "manager_min_balance_portion": "0.10",
          "manager_liquidation_balance_portion": "0.05",
          "withdraw_window_s": 2592000,
          "withdraw_duration_s": 259200
        }
      }
    ]
  },
  "error": null,
  "code": null
}
```

**Lake fields**

| Field                   | Type                   | Description                                                       |
| ----------------------- | ---------------------- | ----------------------------------------------------------------- |
| `'address'`             | string                 | Vault account address                                             |
| `'creator'`             | string                 | Creator address                                                   |
| `'manager'`             | string or null         | Current manager address                                           |
| `'nickname'`            | string or null         | Optional vault nickname                                           |
| `'lp_shares'`           | decimal string         | Total LP shares outstanding                                       |
| `'manager_shares'`      | decimal string         | Total manager shares outstanding                                  |
| `'lp_balance'`          | decimal string         | Balance attributed to LP shares                                   |
| `'manager_balance'`     | decimal string         | Balance attributed to manager shares                              |
| `'last_checked_equity'` | decimal string         | Most recent equity snapshot used for vault accounting             |
| `'high_watermark'`      | decimal string         | High-water mark for performance fee accounting                    |
| `'created_at'`          | integer                | Vault creation timestamp in milliseconds                          |
| `'referrer'`            | string or null         | Referrer address if a referral code was claimed                   |
| `'user_share'`          | decimal string or null | Share balance for the queried account, when `account` is provided |
| `'config'`              | object or null         | Vault configuration, when present                                 |

**Config fields**

| Field                                   | Type                   | Description                        |
| --------------------------------------- | ---------------------- | ---------------------------------- |
| `'deposit_cap'`                         | decimal string or null | LP deposit cap                     |
| `'manager_profit_share'`                | decimal string or null | Performance fee fraction           |
| `'manager_loss_share'`                  | decimal string or null | Manager loss share setting         |
| `'deposit_min_duration_ms'`             | integer or null        | Minimum deposit duration           |
| `'manager_min_balance_portion'`         | decimal string or null | Required manager balance ratio     |
| `'manager_liquidation_balance_portion'` | decimal string or null | Halt/liquidation trigger ratio     |
| `'withdraw_window_s'`                   | integer or null        | Withdrawal cycle period            |
| `'withdraw_duration_s'`                 | integer or null        | Open withdrawal duration per cycle |

* Status 500: Internal server error