---
name: liquidation-oracle.api.klymax402.com
description: liquidation-oracle.api.klymax402.com exposes a single endpoint that returns at-risk DeFi lending positions and their liquidation trigger prices across protocols including Aave, Compound, Morpho, and Venus. It aggregates USD exposure totals across pools and caches results for efficient repeated querying. The host is purpose-built for liquidation risk surveillance, not general DeFi data.
host: liquidation-oracle.api.klymax402.com
---

# liquidation-oracle.api.klymax402.com

This host is a narrow, specialized oracle focused exclusively on liquidation risk in DeFi lending markets. It serves agents that need to identify undercollateralized positions, estimate cascade liquidation exposure before large price moves, or monitor protocol-level collateral health by asset. It does not cover yield data, swap routing, or wallet balances — those concerns belong to separate hosts.

## When to use this host

Use this host when an agent needs to find positions at risk of liquidation on Aave, Compound, Morpho, or Venus, assess cascade liquidation risk ahead of a large market move, or monitor collateral exposure by asset or protocol. Do not use it for yield comparisons (use a defi_find_best_yields host instead), swap quotes (use a dex_get_swap_quote host instead), or wallet portfolio lookups (use a wallet_get_portfolio host instead). Because this host has only one skill with no complementary data endpoints, it should be treated as a single-purpose lookup node within a larger multi-host workflow rather than a standalone research tool.

## Capabilities

### Liquidation Risk Surveillance

Identifies positions approaching liquidation thresholds across major DeFi lending protocols and returns aggregate USD exposure, enabling risk assessment at both the position and protocol level.

- **`fetch-liquidation-levels`** — Returns at-risk DeFi lending positions and liquidation trigger prices across protocols such as Aave, Compound, Morpho, and Venus, with aggregate USD exposure totals.

## Skill reference

### `fetch-liquidation-levels`

**Liquidation Levels Oracle** — Returns at-risk DeFi lending positions and liquidation trigger prices across protocols such as Aave, Compound, Morpho, and Venus, with aggregate USD exposure totals.

*Use when:* Use when an agent needs to identify positions at risk of liquidation in DeFi lending protocols, assess cascade liquidation risk before large market moves, or monitor protocol-level collateral exposure by asset or protocol.

*Not for:* Do not use for yield comparisons (use defi_find_best_yields instead), swap quotes (use dex_get_swap_quote instead), or wallet balance lookups (use wallet_get_portfolio instead).

**Inputs:**

- `protocol` (string) — Filter by lending protocol. Accepted values: aave, compound, morpho, venus. Omit or pass 'all' to include all protocols.
- `asset` (string) — Filter by collateral asset symbol. Omit to return all assets.
- `minValueUsd` (number) — Minimum at-risk position value in USD to include in results. Defaults to 10000.
- `limit` (number) — Number of position results to return. Default is 20, maximum is 100.

**Returns:** Returns a JSON object with protocol/asset filter echoes, a results count, total pools analyzed, an aggregate object with total USD at risk and pool risk counts, a cache expiry timestamp, and a levels array of at-risk positions with liquidation and current prices.

**Example:** `GET https://liquidation-oracle.api.klymax402.com/api/levels?protocol=aave&asset=WETH&minValueUsd=50000&limit=20`

---