HyperLend Risk API

🔑

QuickNode Exclusive

1Supported chain 7RPC Methods 2Plans

Starting at $20.00

Back to Marketplace

This add-on is currently in Beta

Feel free to test it, we would appreciate feedback to address any errors that may occur

Supported Chains

Published on Aug 28, 2025

Support Website Support Email

Real-time risk monitoring and liquidation analytics API for HyperLend Protocol on Hyperliquid.

The HyperLend Risk Management API provides real-time risk monitoring and analytics for positions on HyperLend Protocol within the Hyperliquid ecosystem. It delivers accurate health factor calculations and risk metrics using actual protocol data.

Core Capabilities

Real-Time Risk Monitoring

Health Factor Calculation: Live health factor monitoring using actual HyperLend protocol reserves and position data
Position Analysis: Detailed breakdown of collateral and debt positions with accurate USD valuations
Liquidation Price Calculation: Calculate liquidation prices for active positions
Multi-Asset Support: Supports 12+ protocol assets including WHYPE, UETH, UBTC, and stablecoins

RPC Methods

Download OpenAPI Spec

risk.getPriceImpactScenarios

Documentation

Calculate health factor changes under various price scenarios

Sample code

Curl
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"risk.getPriceImpactScenarios","params":{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3", "scenarios":[{"asset":"WHYPE", "priceChange":-0.15}, {"asset":"WHYPE", "priceChange":-0.25}, {"asset":"UETH", "priceChange":-0.3}]},"id":1,"jsonrpc":"2.0"}'

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'risk.getPriceImpactScenarios',{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","scenarios":[{"asset":"WHYPE","priceChange":-0.15},{"asset":"WHYPE","priceChange":-0.25},{"asset":"UETH","priceChange":-0.3}]}
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"risk.getPriceImpactScenarios","params":{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","scenarios":[{"asset":"WHYPE","priceChange":-0.15},{"asset":"WHYPE","priceChange":-0.25},{"asset":"UETH","priceChange":-0.3}]}
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "risk.getPriceImpactScenarios",{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","scenarios":[{"asset":"WHYPE","priceChange":-0.15},{"asset":"WHYPE","priceChange":-0.25},{"asset":"UETH","priceChange":-0.3}]}
  );
  console.log(network);
})();

risk.getHealthFactor

Get current health factor and risk metrics for a specific address

Sample code

Curl
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"risk.getHealthFactor","params":{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3", "includeSubAccounts":false},"id":1,"jsonrpc":"2.0"}'

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'risk.getHealthFactor',{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","includeSubAccounts":false}
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"risk.getHealthFactor","params":{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","includeSubAccounts":false}
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "risk.getHealthFactor",{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","includeSubAccounts":false}
  );
  console.log(network);
})();

risk.getPositionDetails

Get detailed breakdown of all positions contributing to risk

Sample code

Curl
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"risk.getPositionDetails","params":{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3", "poolType":"all"},"id":1,"jsonrpc":"2.0"}'

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'risk.getPositionDetails',{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","poolType":"all"}
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"risk.getPositionDetails","params":{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","poolType":"all"}
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "risk.getPositionDetails",{"address":"0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","poolType":"all"}
  );
  console.log(network);
})();

utils.getProtocolMetrics

Get current protocol-wide risk metrics

Sample code

Curl
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"utils.getProtocolMetrics","params":{},"id":1,"jsonrpc":"2.0"}'

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'utils.getProtocolMetrics',{}
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"utils.getProtocolMetrics","params":{}
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "utils.getProtocolMetrics",{}
  );
  console.log(network);
})();

utils.validateAddress

Validate if an address has positions on HyperLend

Sample code

Curl
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"utils.validateAddress","params":{"address":"0x63af859d7b4717bd4d3705f15b6d4caad6cf4b36"},"id":1,"jsonrpc":"2.0"}'

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'utils.validateAddress',{"address":"0x63af859d7b4717bd4d3705f15b6d4caad6cf4b36"}
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"utils.validateAddress","params":{"address":"0x63af859d7b4717bd4d3705f15b6d4caad6cf4b36"}
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "utils.validateAddress",{"address":"0x63af859d7b4717bd4d3705f15b6d4caad6cf4b36"}
  );
  console.log(network);
})();

portfolio.getPortfolioRisk

Get risk assessment across multiple addresses

Sample code

Curl
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"portfolio.getPortfolioRisk","params":{"addresses":["0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3", "0x63af859d7b4717bd4d3705f15b6d4caad6cf4b36"], "aggregateView":true},"id":1,"jsonrpc":"2.0"}'

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'portfolio.getPortfolioRisk',{"addresses":["0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","0x63af859d7b4717bd4d3705f15b6d4caad6cf4b36"],"aggregateView":true}
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"portfolio.getPortfolioRisk","params":{"addresses":["0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","0x63af859d7b4717bd4d3705f15b6d4caad6cf4b36"],"aggregateView":true}
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "portfolio.getPortfolioRisk",{"addresses":["0x5de5fc77fa43dda4155ce70edb0be683c0cc03c3","0x63af859d7b4717bd4d3705f15b6d4caad6cf4b36"],"aggregateView":true}
  );
  console.log(network);
})();

utils.getSupportedAssets

Get list of supported assets with risk parameters

Sample code

Curl
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"utils.getSupportedAssets","params":{},"id":1,"jsonrpc":"2.0"}'

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'utils.getSupportedAssets',{}
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"utils.getSupportedAssets","params":{}
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "utils.getSupportedAssets",{}
  );
  console.log(network);
})();

Supported Chains

Published on Aug 28, 2025

Support Website Support Email

Plans & features

Starter - $20/month

Starter - $20/month
Business - $249/month

Enterprise Sales

Starter

$20.00/month

Business

$249.00/month

Enterprise

Starter

$20.00/month