DeFi Liquidation Oracle API

io.github.Br0ski777由 GitHub 账号 Br0ski777 发布v1.1.0更新于 Oct 24, 2026

Real-time DeFi liquidation risk levels by protocol and asset. DeFiLlama-powered. x402.

已验证SSE可网页运行金融数据与分析

概览

AI 生成的概览

远程 MCP 端点,按借贷协议和抵押资产返回实时 DeFi 清算风险水平,按次付费。

可以做什么
查询 Aave、Compound、Morpho、Venus 等 DeFi 借贷协议的清算风险水平,可按协议、抵押资产、最低风险美元金额和返回条数筛选。查看风险仓位,包括所有者、抵押价值、清算价格、当前价格和距清算的百分比。查看各协议的风险总美元价值。
适用场景
适合在市场大幅波动时识别连锁清算风险,也适合清算机器人运营者或需要协议级风险敞口的风险监控场景。
运行要求
需要一个指向该服务器 MCP 地址的远程 MCP 客户端,无需 API 密钥或注册。每次调用通过 x402 协议以 Base L2 上的 USDC 付费,因此需要支持 x402 的客户端和已充值的钱包,并需要能访问该端点的网络。
安装前请注意
每次调用都会产生费用(levels 工具标价 0.003 美元),以 Base 上的 USDC 结算,因此智能体可能从已连接的钱包中扣款。支付由第三方服务商(Coinbase CDP、PayAI)处理。该服务器只读,返回风险数据,不构成交易建议。

安装

在 SourceWeft 中

  1. 打开 控制台中的 DeFi Liquidation Oracle API,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 SSE。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.Br0ski777%2Fliquidation-oracle/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

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.):

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

Quickstart -- HTTP (x402)

bash
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

ToolMethodPathPriceDescription
defi_get_liquidation_levelsGET/api/levels$0.003Get 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

NameTypeRequiredDescription
protocolstringnoFilter by protocol (e.g. aave, compound, morpho, venus). Use 'all' or omit for all protocols.
assetstringnoFilter by collateral asset symbol (e.g. ETH, WBTC, stETH). Optional — returns all assets if omitted.
minValueUsdnumbernoMinimum at-risk value in USD to include (default: 10000)
limitnumbernoNumber 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:

json
{"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

来源:README.md,提交 7e2a367

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式必需10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分