cerebrus_liquidations
Map liquidation clusters across 5 leverage tiers for any Hyperliquid perpetual. Get cascade risk level, estimated USD at each zone, and proximity alerts to avoid cascade liquidations.
Instructions
Get estimated liquidation heatmap for a Hyperliquid perpetual. Maps where liquidation clusters sit across 5 leverage tiers (3x-50x) for both longs and shorts. Returns cascade risk level (LOW/MODERATE/HIGH/EXTREME), estimated USD at each zone, proximity to current price, long/short ratio from funding skew, and nearest cluster alert. No other MCP provider offers this signal. Cost: $0.03 USDC via x402.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | Yes | Coin ticker (e.g., BTC, ETH, SOL). Case-insensitive. |
Implementation Reference
- src/cerebrus_pulse_mcp/server.py:426-428 (handler)Handler for cerebrus_liquidations — validates coin argument and calls GET /liquidations/{coin}
elif name == "cerebrus_liquidations": coin = _validate_coin(arguments["coin"]) result = _api_get(f"/liquidations/{coin}") - Tool definition (schema) for cerebrus_liquidations — describes input schema requiring a 'coin' string parameter
Tool( name="cerebrus_liquidations", description=( "Get estimated liquidation heatmap for a Hyperliquid perpetual. " "Maps where liquidation clusters sit across 5 leverage tiers (3x-50x) " "for both longs and shorts. Returns cascade risk level " "(LOW/MODERATE/HIGH/EXTREME), estimated USD at each zone, proximity " "to current price, long/short ratio from funding skew, and nearest " "cluster alert. No other MCP provider offers this signal. " "Cost: $0.03 USDC via x402." ), inputSchema={ "type": "object", "properties": { "coin": { "type": "string", "description": "Coin ticker (e.g., BTC, ETH, SOL). Case-insensitive.", }, }, "required": ["coin"], }, ), - src/cerebrus_pulse_mcp/server.py:88-89 (registration)Registration via @server.list_tools() decorator — the Tool object for cerebrus_liquidations is included in the returned list
@server.list_tools() async def list_tools() -> list[Tool]: - src/cerebrus_pulse_mcp/server.py:369-370 (registration)Registration via @server.call_tool() decorator — dispatches to the handler branch for cerebrus_liquidations
@server.call_tool() async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent]: - CLI helper mapping for liquidations tool — maps the CLI name to API path /liquidations/{coin}
"liquidations": ("/liquidations/{coin}", [("coin", True, str, None)]),