> For the complete documentation index, see [llms.txt](https://docs.bsc.lista.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bsc.lista.org/zh-cn/kai-fa-zhe/services/lending-api/vault.md).

# 金库

金库是 LP 存入资产的聚合合约；其流动性会被分配到多个借贷市场。以下所有路径均位于 **Base URL** `/api/moolah` 之下。

***

## 1. 金库列表

### GET /api/moolah/vault/list

支持过滤与排序的金库分页列表。

|            |                          |
| ---------- | ------------------------ |
| **Method** | `GET`                    |
| **Path**   | `/api/moolah/vault/list` |

#### 查询参数

| 参数          | 类型              | 必填 | 说明                                        |
| ----------- | --------------- | -- | ----------------------------------------- |
| `chainId`   | number / string | 否  | 按链过滤（例如 56、1）。                            |
| `page`      | number          | 否  | 页码（从 1 开始）。默认值：1。                         |
| `pageSize`  | number          | 否  | 每页条数。默认值：10 或 20。                         |
| `sortBy`    | string          | 否  | 排序字段（例如 `totalAssets`、`apy`、`createdAt`）。 |
| `sortOrder` | string          | 否  | `asc` 或 `desc`。                           |

#### 响应

| 字段      | 类型     | 说明         |
| ------- | ------ | ---------- |
| `list`  | array  | 金库对象列表。    |
| `total` | number | 总条数（用于分页）。 |

**`list` 中的条目：**

| 字段               | 类型     | 说明                |
| ---------------- | ------ | ----------------- |
| `vaultId`        | string | 金库标识符（例如合约地址）。    |
| `chainId`        | number | 链 ID。             |
| `asset`          | string | 存款资产地址或代号。        |
| `assetSymbol`    | string | 代号（例如 WBNB、USD1）。 |
| `totalAssets`    | string | 金库内总资产（可读格式）。     |
| `totalAssetsUsd` | string | 以 USD 计的总价值。      |
| `apy`            | string | 当前存款 APY。         |
| `marketCount`    | number | 该金库分配流动性的市场数量。    |

***

## 2. 金库详情

### GET /api/moolah/vault/info

单个金库的完整详情。

|            |                          |
| ---------- | ------------------------ |
| **Method** | `GET`                    |
| **Path**   | `/api/moolah/vault/info` |

#### 查询参数

| 参数        | 类型              | 必填 | 说明                     |
| --------- | --------------- | -- | ---------------------- |
| `vaultId` | string          | 是  | 金库标识符（例如合约地址）。         |
| `chainId` | number / string | 否  | 链 ID（若该金库存在于多条链上则为必填）。 |

#### 响应

| 字段                  | 类型             | 说明                 |
| ------------------- | -------------- | ------------------ |
| `vaultId`           | string         | 金库标识符。             |
| `chainId`           | number         | 链 ID。              |
| `asset`             | string         | 存款资产地址。            |
| `assetSymbol`       | string         | 代号。                |
| `totalAssets`       | string         | 总资产。               |
| `totalAssetsUsd`    | string         | 以 USD 计的总价值。       |
| `apy`               | string         | 当前存款 APY。          |
| `marketIds`         | array          | 该金库供应流动性的市场 ID 列表。 |
| `allocationSummary` | object / array | 各市场的分配情况（金额或比例）。   |

***

## 3. 金库存款 / APY 历史

### GET /api/moolah/vault/deposit/history

### GET /api/moolah/vault/apy/history

两者均返回某金库在指定时间区间内存款规模与 APY 的每日快照。响应结构相同。

|            |                                                                       |
| ---------- | --------------------------------------------------------------------- |
| **Method** | `GET`                                                                 |
| **Path**   | `/api/moolah/vault/deposit/history` 或 `/api/moolah/vault/apy/history` |

#### 查询参数

| 参数          | 类型              | 必填 | 说明           |
| ----------- | --------------- | -- | ------------ |
| `vaultId`   | string          | 是  | 金库标识符。       |
| `chainId`   | number / string | 否  | 链 ID。        |
| `startTime` | number / string | 否  | 起始时间戳（秒或毫秒）。 |
| `endTime`   | number / string | 否  | 结束时间戳。       |

#### 响应

每日快照对象数组：

| 字段                | 类型     | 说明                 |
| ----------------- | ------ | ------------------ |
| `date`            | string | 日期（例如 YYYY-MM-DD）。 |
| `timestamp`       | number | 当日起始时间戳。           |
| `totalDeposit`    | string | 该日金库内的总存款。         |
| `totalDepositUsd` | string | 以 USD 计的价值。        |
| `apy`             | string | 该日的 APY。           |

***

## 4. 金库分配

### GET /api/moolah/vault/allocation

金库流动性在各市场间分配情况的分页列表。

|            |                                |
| ---------- | ------------------------------ |
| **Method** | `GET`                          |
| **Path**   | `/api/moolah/vault/allocation` |

#### 查询参数

| 参数         | 类型              | 必填 | 说明     |
| ---------- | --------------- | -- | ------ |
| `vaultId`  | string          | 是  | 金库标识符。 |
| `chainId`  | number / string | 否  | 链 ID。  |
| `page`     | number          | 否  | 页码。    |
| `pageSize` | number          | 否  | 每页条数。  |

#### 响应

| 字段      | 类型     | 说明     |
| ------- | ------ | ------ |
| `list`  | array  | 分配记录行。 |
| `total` | number | 总条数。   |

**`list` 中的条目：**

| 字段                | 类型     | 说明                |
| ----------------- | ------ | ----------------- |
| `marketId`        | string | 市场标识符。            |
| `allocatedAssets` | string | 分配到该市场的数量。        |
| `proportion`      | string | 占比（例如 0.5 = 50%）。 |
| `apy`             | string | 该市场的存款 APY。       |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bsc.lista.org/zh-cn/kai-fa-zhe/services/lending-api/vault.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.