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

# borrowLendReserveState | Hyperliquid info

> The info endpoint with type: "borrowLendReserveState" retrieves the reserve state for a specific token in the Hyperliquid borrow/lend market.

<Info>
  This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
</Info>

The `info` endpoint with `type: "borrowLendReserveState"` retrieves the reserve state for a specific token in the Hyperliquid borrow/lend market. Returns current rates, utilization, and supply/borrow totals.

## Parameters

### Request body

* `type` (string, required) — The request type. Must be `"borrowLendReserveState"`.
* `token` (integer, required) — Token index (e.g., `0` for USDC).

## Response

The response is an object containing:

* `borrowYearlyRate` (string) — Annual borrow interest rate.
* `supplyYearlyRate` (string) — Annual supply interest rate.
* `balance` (string) — Available balance in the reserve.
* `utilization` (string) — Current utilization ratio of the reserve.
* `oraclePx` (string) — Oracle price of the token.
* `ltv` (string) — Loan-to-value ratio for the token as collateral.
* `totalSupplied` (string) — Total amount supplied to the reserve.
* `totalBorrowed` (string) — Total amount borrowed from the reserve.

## Example request

<CodeGroup>
  ```shell Shell theme={"system"}
  curl -X POST \
    -H "Content-Type: application/json" \
    -d '{"type": "borrowLendReserveState", "token": 0}' \
    https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info
  ```

  ```python Python (hyperliquid-python-sdk) theme={"system"}
  from hyperliquid.info import Info

  # The Python SDK has no dedicated borrowLendReserveState method,
  # so post the request type directly through the shared post() helper.
  info = Info("YOUR_CHAINSTACK_ENDPOINT", skip_ws=True)

  reserve_state = info.post("/info", {"type": "borrowLendReserveState", "token": 0})
  print(reserve_state)
  ```

  ```typescript TypeScript (@nktkas/hyperliquid) theme={"system"}
  import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";

  const transport = new HttpTransport({ apiUrl: "YOUR_CHAINSTACK_ENDPOINT" });
  const info = new InfoClient({ transport });

  const reserveState = await info.borrowLendReserveState({ token: 0 });
  console.log(reserveState);
  ```
</CodeGroup>

<Note>
  **Use your own endpoint in your code.** The code examples use a placeholder Chainstack endpoint (YOUR\_CHAINSTACK\_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the [Chainstack console](https://console.chainstack.com/). The curl above uses a shared public endpoint for quick checks only; do not use it in production.
</Note>

## Example response

```json theme={"system"}
{
  "borrowYearlyRate": "0.05",
  "supplyYearlyRate": "0.0010632437",
  "balance": "3464255.80696283",
  "utilization": "0.0236276367",
  "oraclePx": "1.0",
  "ltv": "0.0",
  "totalSupplied": "3548088.6923081698",
  "totalBorrowed": "83832.95076168"
}
```

## Use case

The `info` endpoint with `type: "borrowLendReserveState"` is useful for:

* Displaying current borrow and supply rates for a specific token
* Monitoring reserve utilization to anticipate rate changes
* Building lending market dashboards with real-time reserve data
* Calculating potential yields before supplying assets


## OpenAPI

````yaml openapi/hyperliquid_node_api/hypercore_info/info_borrow_lend_reserve_state.json post /4f8d8f4040bdacd1577bff8058438274/info
openapi: 3.0.0
info:
  title: Hyperliquid Node API
  version: 1.0.0
  description: This is an API for interacting with Chainstack Hyperliquid node.
servers:
  - url: https://hyperliquid-mainnet.core.chainstack.com
security: []
paths:
  /4f8d8f4040bdacd1577bff8058438274/info:
    post:
      tags:
        - hyperliquid operations
      summary: info (borrowLendReserveState)
      operationId: infoBorrowLendReserveState
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  description: Request type
                  default: borrowLendReserveState
                  enum:
                    - borrowLendReserveState
                token:
                  type: integer
                  description: Token index (e.g., 0 for USDC)
                  default: 0
              required:
                - type
                - token
      responses:
        '200':
          description: Reserve state for the specified token
          content:
            application/json:
              schema:
                type: object

````