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


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