> 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/for-developer/services/lending-api/market.md).

# Market

A lending market is defined by a collateral/loan asset pair, LLTV, and oracle. All paths are under **Base URL** `/api/moolah`.

***

## 1. Market list

### GET /api/moolah/borrow/markets

Paginated list of borrow markets with filters.

|            |                              |
| ---------- | ---------------------------- |
| **Method** | `GET`                        |
| **Path**   | `/api/moolah/borrow/markets` |

#### Query parameters

| Parameter         | Type            | Required | Description                      |
| ----------------- | --------------- | -------- | -------------------------------- |
| `chainId`         | number / string | No       | Filter by chain.                 |
| `collateralAsset` | string          | No       | Collateral token address.        |
| `loanAsset`       | string          | No       | Loan token address.              |
| `page`            | number          | No       | Page number.                     |
| `pageSize`        | number          | No       | Items per page.                  |
| `sortBy`          | string          | No       | e.g. `totalBorrow`, `borrowApy`. |
| `sortOrder`       | string          | No       | `asc` or `desc`.                 |

#### Response

| Field   | Type   | Description     |
| ------- | ------ | --------------- |
| `list`  | array  | Market objects. |
| `total` | number | Total count.    |

**Item in `list`:**

| Field              | Type   | Description                 |
| ------------------ | ------ | --------------------------- |
| `marketId`         | string | Market identifier.          |
| `chainId`          | number | Chain ID.                   |
| `collateralAsset`  | string | Collateral token address.   |
| `collateralSymbol` | string | Collateral symbol.          |
| `loanAsset`        | string | Loan token address.         |
| `loanSymbol`       | string | Loan symbol.                |
| `lltv`             | string | Liquidation LTV (e.g. 0.8). |
| `totalSupply`      | string | Total supplied.             |
| `totalBorrow`      | string | Total borrowed.             |
| `supplyApy`        | string | Supply APY.                 |
| `borrowApy`        | string | Borrow APY.                 |
| `utilization`      | string | Utilization ratio.          |

***

## 2. Market detail

### GET /api/moolah/market/:marketId

Full details for one market, including oracles.

|            |                                |
| ---------- | ------------------------------ |
| **Method** | `GET`                          |
| **Path**   | `/api/moolah/market/:marketId` |

#### Path parameters

| Parameter  | Type   | Description                                  |
| ---------- | ------ | -------------------------------------------- |
| `marketId` | string | Market identifier (e.g. bytes32 or address). |

#### Response

| Field               | Type   | Description                      |
| ------------------- | ------ | -------------------------------- |
| `marketId`          | string | Market identifier.               |
| `chainId`           | number | Chain ID.                        |
| `collateralAsset`   | string | Collateral token address.        |
| `collateralSymbol`  | string | Symbol.                          |
| `loanAsset`         | string | Loan token address.              |
| `loanSymbol`        | string | Symbol.                          |
| `lltv`              | string | Liquidation LTV.                 |
| `totalSupply`       | string | Total supplied.                  |
| `totalBorrow`       | string | Total borrowed.                  |
| `supplyApy`         | string | Supply APY.                      |
| `borrowApy`         | string | Borrow APY.                      |
| `utilization`       | string | Utilization.                     |
| `collateralOracles` | array  | Oracle config(s) for collateral. |
| `loanOracles`       | array  | Oracle config(s) for loan asset. |

**Oracle item** (in `collateralOracles` / `loanOracles`):

| Field     | Type   | Description                   |
| --------- | ------ | ----------------------------- |
| `address` | string | Oracle contract address.      |
| `url`     | string | Optional explorer or doc URL. |
| `descEn`  | string | English description.          |
| `descCn`  | string | Chinese description.          |

For **PT-style (principal token)** collateral, items may also include:

| Field             | Type   | Description                |
| ----------------- | ------ | -------------------------- |
| `discountOracle`  | string | Discount oracle address.   |
| `baseTokenOracle` | string | Base token oracle address. |
| `baseToken`       | string | Base token address.        |
| `baseTokenSymbol` | string | Base token symbol.         |

***

## 3. Vaults by market

### GET /api/moolah/market/vault/:marketId

Paginated list of vaults that supply liquidity to the given market.

|            |                                      |
| ---------- | ------------------------------------ |
| **Method** | `GET`                                |
| **Path**   | `/api/moolah/market/vault/:marketId` |

#### Path parameters

| Parameter  | Type   | Description        |
| ---------- | ------ | ------------------ |
| `marketId` | string | Market identifier. |

#### Query parameters

| Parameter  | Type   | Required | Description     |
| ---------- | ------ | -------- | --------------- |
| `page`     | number | No       | Page number.    |
| `pageSize` | number | No       | Items per page. |

#### Response

| Field   | Type   | Description    |
| ------- | ------ | -------------- |
| `list`  | array  | Vault entries. |
| `total` | number | Total count.   |

**Item in `list`:**

| Field             | Type   | Description                               |
| ----------------- | ------ | ----------------------------------------- |
| `vaultId`         | string | Vault identifier.                         |
| `allocatedAmount` | string | Amount supplied to this market.           |
| `share`           | string | Share of market supply (e.g. proportion). |

***

## 4. Market borrow rate history

### GET /api/moolah/market/borrowRate/:marketId

Historical borrow rate (or APY) for the market.

|            |                                           |
| ---------- | ----------------------------------------- |
| **Method** | `GET`                                     |
| **Path**   | `/api/moolah/market/borrowRate/:marketId` |

#### Path parameters

| Parameter  | Type   | Description        |
| ---------- | ------ | ------------------ |
| `marketId` | string | Market identifier. |

#### Query parameters

| Parameter   | Type            | Required | Description         |
| ----------- | --------------- | -------- | ------------------- |
| `startTime` | number / string | No       | Start timestamp.    |
| `endTime`   | number / string | No       | End timestamp.      |
| `interval`  | string          | No       | e.g. `day`, `hour`. |

#### Response

Array of rate points:

| Field        | Type   | Description                         |
| ------------ | ------ | ----------------------------------- |
| `timestamp`  | number | Point time.                         |
| `borrowRate` | string | Borrow rate (per second or annual). |
| `borrowApy`  | string | Borrow APY.                         |

***

## 5. All markets (on-chain)

### GET /api/moolah/allMarkets

Returns all markets with **on-chain base parameters** (for building transaction params). No pagination.

|            |                          |
| ---------- | ------------------------ |
| **Method** | `GET`                    |
| **Path**   | `/api/moolah/allMarkets` |

#### Query parameters

| Parameter | Type            | Required | Description                           |
| --------- | --------------- | -------- | ------------------------------------- |
| `chainId` | number / string | No       | Filter by chain. Omit for all chains. |

#### Response

Array of market config objects. Each item typically includes:

| Field             | Type   | Description                  |
| ----------------- | ------ | ---------------------------- |
| `marketId`        | string | Market id (e.g. bytes32).    |
| `chainId`         | number | Chain ID.                    |
| `collateralAsset` | string | Collateral token address.    |
| `loanAsset`       | string | Loan token address.          |
| `oracle`          | string | Oracle contract address.     |
| `lltv`            | string | Liquidation LTV.             |
| `irm`             | string | Interest rate model address. |

Exact fields follow the contract’s `MarketParams` or equivalent.

***

## 6. Market search / filters

### GET /api/moolah/market/search/:typeId

Returns filter options or search results for markets by type (e.g. collateral type, category).

|            |                                     |
| ---------- | ----------------------------------- |
| **Method** | `GET`                               |
| **Path**   | `/api/moolah/market/search/:typeId` |

#### Path parameters

| Parameter | Type   | Description                                  |
| --------- | ------ | -------------------------------------------- |
| `typeId`  | string | Filter type (e.g. `collateral`, `category`). |

#### Response

Shape is implementation-specific: often an array of options `{ value, label }` or a list of market IDs matching the type.


---

# 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/for-developer/services/lending-api/market.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.