POST request to https://api.hyperliquid.xyz/info with a JSON body. The relevant request types are borrowLendUserState, borrowLendReserveState, and allBorrowLendReserveStates. These endpoints return account and reserve data; they do not submit borrow or lend actions.
This article includes a Hyperliquid referral link. If you sign up, supa.is may earn a commission; the referee gets a 4% fee discount on the first $25M of volume per account. Vaults and sub-accounts are excluded.
The request and response shapes below are from the Hyperliquid info endpoint documentation, accessed 2026-11-13.
Endpoint and headers
Use the same info endpoint for all three queries:
POST https://api.hyperliquid.xyz/info
Content-Type: application/json
For user-specific queries, pass the actual address of the master or sub-account you want to inspect. The documentation notes that using an agent wallet address can return an empty result.
Query borrow/lend user state
Request body:
| Field | Type | Required | Description |
|---|---|---|---|
type | String | Yes | borrowLendUserState |
user | String | Yes | Account address in hexadecimal format, e.g. 0x0000000000000000000000000000000000000000 |
{
"type": "borrowLendUserState",
"user": "0x0000000000000000000000000000000000000000"
}
Example response:
{
"tokenToState": [
[
0,
{
"borrow": {
"basis": "0.0",
"value": "0.0"
},
"supply": {
"basis": "44.69295862",
"value": "44.69692314"
}
}
],
[
1105,
{
"borrow": {
"basis": "0.0",
"value": "0.0"
},
"supply": {
"basis": "0.0",
"value": "0.0"
}
}
]
],
"health": "healthy",
"healthFactor": null
}
Documented response fields:
| Field | Meaning in the documented response |
|---|---|
tokenToState | Array of [token index, state] pairs |
borrow.basis | Borrow basis value for the token |
borrow.value | Borrow value for the token |
supply.basis | Supply basis value for the token |
supply.value | Supply value for the token |
health | Account health string; the example returns "healthy" |
healthFactor | Health factor field; the example returns null |
Query borrow/lend reserve state
Request body:
Like what you're reading? Try it yourself — this link supports ChartedTrader at no cost to you.
Create a Hyperliquid account →| Field | Type | Required | Description |
|---|---|---|---|
type | String | Yes | borrowLendReserveState |
token | Number | Yes | Token index |
{
"type": "borrowLendReserveState",
"token": 0
}
Example response:
{
"borrowYearlyRate": "0.05",
"supplyYearlyRate": "0.0008245002",
"balance": "3245939.4732256099",
"utilization": "0.018322226",
"oraclePx": "1.0",
"ltv": "0.0",
"totalSupplied": "3306509.7335290499",
"totalBorrowed": "60582.61869494"
}
Documented reserve-state fields:
| Field | Description |
|---|---|
borrowYearlyRate | Borrow yearly rate |
supplyYearlyRate | Supply yearly rate |
balance | Reserve balance |
utilization | Reserve utilization |
oraclePx | Oracle price |
ltv | Loan-to-value parameter |
totalSupplied | Total supplied amount |
totalBorrowed | Total borrowed amount |
Query all borrow/lend reserve states
Request body:
| Field | Type | Required | Description |
|---|---|---|---|
type | String | Yes | allBorrowLendReserveStates |
{
"type": "allBorrowLendReserveStates"
}
Example response:
[
[
0,
{
"borrowYearlyRate": "0.05",
"supplyYearlyRate": "0.0008244951",
"balance": "3245960.0596176102",
"utilization": "0.0183221137",
"oraclePx": "1.0",
"ltv": "0.0",
"totalSupplied": "3306530.3251102199",
"totalBorrowed": "60582.62446067"
}
],
[
150,
{
"borrowYearlyRate": "0.05",
"supplyYearlyRate": "0.0",
"balance": "11318.09684696",
"utilization": "0.0",
"oraclePx": "23.99",
"ltv": "0.5",
"totalSupplied": "11318.09684696",
"totalBorrowed": "0.0"
}
]
]
The bulk response is an array of [token index, reserve state] pairs. Use it when you need reserve parameters for multiple tokens in one request.
How to use the outputs
- Use
borrowLendUserStateto inspect an account's borrow and supply entries by token index. - Use
borrowLendReserveStateto inspect one reserve's rates, utilization, oracle price, LTV, and totals. - Use
allBorrowLendReserveStatesto inspect all documented reserve states in one response. - Check
healthandhealthFactorin the user-state response when monitoring account-level borrow/lend health.
If you want to use these endpoints against a live account, Create a Hyperliquid account.
Continue with Hyperliquid
Browse the Hyperliquid guide hub for the complete user journey.