GET /api/v1/liquidation-headroom

Liquidation headroom, stress-tested.

See how close a Morpho position is to its liquidation threshold. Inspect a free live sample first, then query your own position for 0.05 USDC on Base.

TRY BEFORE YOU INTEGRATE

Inspect real data. No wallet needed.

Inspect a fixed public Morpho position on Base before integrating. The free live sample may be cached for up to 60 seconds. Manual sandbox testing is also free.

Automate custom live queries for 0.05 USDC each via x402 v2. No Morpho Radar account or API key is required. Your client needs a funded Base wallet and must sign a payment authorization; a valid payment is settled before the result is returned.

cURL

curl --fail-with-body -A 'my-morpho-app/1.0' 'https://radar-api.rarefrequencyworks.com/api/v1/sample'

Server integrations: identify your application with a descriptive User-Agent such as my-morpho-app/1.0. Replace the example name with your own; do not impersonate a browser.

Illustrative example · not live

Fixed documentation values. Load the free sample to read the chain.

Liquidation price: 56,312.83; USDC per cbBTC
Current LTV: 62.23%
Price-drop headroom: 27.64%
Example block: 53388605

Fixed public example. Estimates at the reported block; prices, oracle values and debt change. This is not your selected wallet position.

// Example JSON structure · not live

example JSON

{
  "network": "base",
  "protocol": "morpho-blue",
  "source": "onchain_accrued",
  "blockNumber": "53388605",
  "tokens": {
    "loan": {
      "symbol": "USDC",
      "decimals": 6
    },
    "collateral": {
      "symbol": "cbBTC",
      "decimals": 8
    }
  },
  "position": {
    "borrowAssets": "15039923188720",
    "collateral": "31055591657"
  },
  "result": {
    "collateralValue": 24168896.521967094,
    "currentLtv": 0.6222842311005066,
    "lltv": 0.86,
    "liquidationPrice": 56312.83078015194,
    "headroomPct": 27.64136847668528,
    "priceDropToLiquidationPct": 27.64136847668528,
    "healthFactor": 1.382005130483693,
    "maxBorrow": 20785251.0088917,
    "liquidatable": false
  },
  "sample": {
    "kind": "shared_live_sample",
    "customPosition": false,
    "cacheSeconds": 60
  }
}

Testing a client offline? Get the illustrative fixture. For custom positions, read the paid integration guide. The free sample does not test payment settlement.

On-chain position

Market ID (bytes32)Borrower address

Manual inputs — no live result loaded

Collateral assetLoan asset

LLTV (0–1)Collateral amount (WETH)Collateral price (USDC)Borrow amount (USDC)

Price shock-0%

Liquidation price

2,558.1395

USDC per WETH

Current LTV

64.71%

LLTV 86%

Headroom

24.76%

of LLTV unused

Drop to liquidation

24.76%

HF 1.329

LTV gauge

HEALTHY

Stress curve · LTV vs price shock

// equivalent API response.result

{
  "collateralValue": 34000,
  "currentLtv": 0.647059,
  "lltv": 0.86,
  "liquidationPrice": 2558.139535,
  "headroomPct": 24.760602,
  "priceDropToLiquidationPct": 24.760602,
  "healthFactor": 1.329091,
  "maxBorrow": 29240,
  "liquidatable": false
}