> 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/overall.md). # Overall A single protocol-wide summary of Lista Lending (Moolah): aggregate deposits, borrows, and collateral, the best vault APY, the lowest market borrow rate, and the top loan/collateral tokens by size. All paths are under **Base URL** `/api/moolah`. The response is a pre-computed snapshot served from a server-side cache and refreshed periodically by a background job, so values reflect the last sync rather than live on-chain state. Use the `updateAt` timestamp to judge freshness. Most USD amounts are returned as fixed-point decimal strings (18 decimal places) to avoid floating-point loss — but not all: the field tables below mark the ones typed `number`. Check the type per field rather than assuming strings throughout. *** ## GET /api/moolah/overall Returns the protocol snapshot. This endpoint takes **no query parameters**. ### Response | Field | Type | Description | | ------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `totalBorrowed` | string | Total borrowed across all markets, in USD (fixed-point, 18 decimals). | | `totalCollateral` | string | Total collateral posted across all markets, in USD (fixed-point, 18 decimals). | | `totalDeposits` | string | Total assets deposited across all vaults, in USD (fixed-point, 18 decimals). | | `maxVaultApy` | string | Highest **combined** APY (base plus emission) among vaults holding assets (fixed-point, 18 decimals; e.g. `0.05` = 5%). | | `minBorrowRate` | string | Lowest **net** borrow rate (borrow rate minus borrow-emission APY) among markets with non-zero borrows. Can be **negative** when emissions exceed the borrow rate (fixed-point, 18 decimals). | | `loanTokens` | array | Top loan/deposit tokens by deposited USD, sorted descending (up to 10). See below. | | `collateralTokens` | array | Top collateral tokens by available liquidity in USD, sorted descending (up to 10). See below. | | `details` | object | Per-chain breakdown of the same aggregates, keyed by chain (`bsc`, `ethereum`). | | `activeMarketCount` | number | Number of active markets. | | `lpTokens` | array | StableSwap LP tokens accepted as collateral — `tokenSymbol`, `tokenAddress`, `tokenIcon`, `tvlInUSD`. | | `smartLending` | object | Smart Lending sub-totals. | | `bStock` | object | Tokenized-equity (bStock) sub-totals. A **breakout** of markets that are already counted in the aggregates above, not a separate bucket. See below. | | `updateAt` | number | Unix timestamp (seconds) of the snapshot. | Items in both arrays carry `tokenAddress` (lowercase), `tokenSymbol` and `tokenIcon`, plus one USD figure typed **`number`, not a string**: `amountInUSD` (deposited) on `loanTokens`, `liquidityInUSD` (available loan-side liquidity in markets using that collateral) on `collateralTokens`. ### `bStock` object bStock markets are **included** in `totalBorrowed`, `totalCollateral` and the `collateralTokens` list; this object tallies the same markets again so they can be shown on their own. **Do not add `bStock.totalBorrowed` / `bStock.totalCollateral` to the protocol-wide totals** — you would double-count. `totalDeposits` is a vault-level aggregate and has no bStock counterpart. The shape is stable, and present even before the snapshot is populated. | Field | Type | Description | | ---------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------- | | `totalCollateral`, `totalBorrowed`, `totalAvailable` | string | bStock collateral posted, borrowed against it, and available liquidity — all USD, fixed-point 18 decimals. | | `marketCount`, `collateralTokenCount` | number | bStock markets, and distinct bStock collateral tokens. | | `loanTokens`, `topCollateralTokens` | array | Loan tokens available against bStock collateral, and the top bStock collaterals. | When the snapshot has not yet been populated, the endpoint returns a zeroed object: all amount/rate fields as `"0"`, `loanTokens` and `collateralTokens` as empty arrays, `updateAt` as `0`, and `bStock` present with its counts at `0`, its amounts at `"0"` and its arrays empty. ### Example ```bash curl https:///api/moolah/overall ``` ```json { "totalBorrowed": "12345678.900000000000000000", "totalCollateral": "23456789.000000000000000000", "totalDeposits": "34567890.100000000000000000", "maxVaultApy": "0.084000000000000000", "minBorrowRate": "0.021000000000000000", "loanTokens": [ { "tokenAddress": "0x...", "tokenSymbol": "USD1", "tokenIcon": "https://...", "amountInUSD": 20000000.0 } ], "collateralTokens": [ { "tokenSymbol": "BTCB", "tokenAddress": "0x...", "tokenIcon": "https://...", "liquidityInUSD": 8000000.0 } ], "updateAt": 1730000000 } ``` > Values above are illustrative. Token addresses are returned by the API; do not hard-code them. *** ## Related * [Vault API](/for-developer/services/lending-api/vault.md) — per-vault list, detail, APY/deposit history, allocation. * [Market API](/for-developer/services/lending-api/market.md) — per-market data, borrow rates, search. * [Position, Liquidation, Emission](/for-developer/services/lending-api/position-liquidation-emission.md) — user-level data. --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.bsc.lista.org/for-developer/services/lending-api/overall.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.