Skip to main content
Glama

DeFi Liquidation Oracle API

MCP Server x402 License: MIT

DeFi liquidation levels from Aave, Compound, Morpho -- at-risk positions, price triggers, aggregate exposure. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "liquidation-oracle": {
      "url": "https://liquidation-oracle.api.klymax402.com/mcp"
    }
  }
}

Related MCP server: verdix

Quickstart -- HTTP (x402)

curl "https://liquidation-oracle.api.klymax402.com/api/levels"
# -> 402 Payment Required, with an x402 payment challenge in the response body

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

Tool

Method

Path

Price

Description

defi_get_liquidation_levels

GET

/api/levels

$0.003

Get liquidation risk levels for DeFi lending protocols

defi_get_liquidation_levels

Use this when you need to check liquidation risk levels in DeFi lending protocols. Returns at-risk positions and liquidation triggers in JSON.

Parameters

Name

Type

Required

Description

protocol

string

no

Filter by protocol (e.g. aave, compound, morpho, venus). Use 'all' or omit for all protocols.

asset

string

no

Filter by collateral asset symbol (e.g. ETH, WBTC, stETH). Optional — returns all assets if omitted.

minValueUsd

number

no

Minimum at-risk value in USD to include (default: 10000)

limit

number

no

Number of results to return (default: 20, max: 100)

Returns

  • positions -- array of at-risk positions with owner, protocol, collateral asset, collateral value USD

  • liquidationPrice -- price at which the position gets liquidated

  • currentPrice -- current market price of the collateral

  • distancePercent -- how far current price is from liquidation (%)

  • aggregateAtRisk -- total USD value at risk per protocol

  • protocol -- lending protocol name (Aave, Compound, Morpho, Venus)

Example response:

{"positions":[{"protocol":"Aave V3","collateral":"WETH","collateralUsd":245000,"liquidationPrice":2850.00,"currentPrice":3100.00,"distancePercent":8.06}],"aggregateAtRisk":{"Aave V3":12500000},"totalPositions":42}

When to use: large market moves to identify cascade liquidation risk. Essential for liquidation bot operators and risk monitoring.

Not for: yields (use defi_find_best_yields), swap quotes (use dex_get_swap_quote), wallet balance (use wallet_get_portfolio).

Example agent prompts

  • "Check liquidation risk levels in DeFi lending protocols"

Payment

  • Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key

  • Network: Base L2 (eip155:8453)

  • Asset: USDC

  • Facilitator: Coinbase CDP (primary), PayAI (fallback)

  • Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides onchain intelligence tools for Base, including token risk checks, wallet PnL, and leaderboard data, with paid calls settled per-request in USDC via x402.
      45 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to check an EVM address on Base for risk (safe, caution, danger) before sending funds, with reasons, paid per call via x402 from the user's own wallet.
      7
      94 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Exposes JSON-RPC 2.0 tools that let AI agents scan Base L2 lending positions approaching liquidation, simulate flash-loan-backed debt rescue plans, and generate the calldata needed to repay Morpho Blue and Aave v3 debt while avoiding the 5% penalty. Agents and builders can also attach a referral wallet to collect an instant 0.05% USDC revenue share paid atomically in the same block.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to perform token risk checks across BNB Smart Chain, Ethereum, Base, and Arc by simulating real buys and sells plus 70+ contract checks, with tools for reports, feeds, trade simulation, liquidity analysis, and fund tracing. Successful paid calls settle automatically in USDC on Base via x402, with no account or API key required.
      387 npm
      MIT