Repository avatar
Other Tools
v1.1.0
active

liquidation-heatmap

app.hyperperps/liquidation-heatmap

Live Hyperliquid liquidation heatmap: liquidation clusters, stop pools, TP walls, crowd positioning.

Documentation

Hyperliquid Liquidation Heatmap – Crypto Trading – by HyperPerps

Hyperliquid liquidation heatmap and crypto heatmap, live, as a remote MCP server. Ask your AI where BTC, ETH, SOL or HYPE traders get liquidated, where their stop-losses and take-profits rest, and how the crowd is positioned. No API key, no account.

What you get

Each call returns a snapshot built from every Hyperliquid leaderboard account plus every account seen trading the coin. Positions are recomputed about every 2 minutes and republished about every 15 seconds with the latest price.

  • Liquidation clusters — where longs (below price) and shorts (above price) get force-closed, with notional, wallet count and distance from price.
  • Stop-loss pools and take-profit walls — resting orders that act as fuel and as caps.
  • Crowd positioning — net open-interest lean, whales vs retail, trapped size, leverage, fresh money, cascade mass.

Data is anonymized: clusters only, never per-wallet rows.

Install

Claude Code

/plugin marketplace add velinxs/hyperperps-heatmap-plugin
/plugin install hyperperps-liquidation-heatmap@hyperperps

Or add only the MCP server:

claude mcp add --transport http hyperperps https://hyperperps.app/mcp

Claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → https://hyperperps.app/mcp.

Cursor, Windsurf, VS Code and other MCP clients:

{
  "mcpServers": {
    "hyperperps": { "url": "https://hyperperps.app/mcp" }
  }
}

Tool

get_liquidation_heatmap

ArgumentRequiredMeaning
symbolyesMarket, e.g. BTC, ETH, SOL, HYPE
rangenoPercent from price to include, e.g. 25, or all
levelsnoWalls per side, biggest first, e.g. 50, or all

Default: walls within 5% of price, the biggest per side.

get_heatmap_field_definitions (no arguments) returns what every field means.

Example prompts:

  • "Where are the biggest BTC liquidation clusters right now?"
  • "Show ETH stop-loss pools within 10% of price."
  • "Is the HYPE crowd long or short, and how much of it is underwater?"
  • "Give me SOL's full liquidation ladder."

HTTP API

The same data without MCP:

curl https://hyperperps.app/api/public/heatmap/BTC

Field definitions: https://hyperperps.app/api/public/heatmap, or the get_heatmap_field_definitions tool.

Always current

This plugin is a thin pointer to the hosted server. Tool list, field definitions and usage notes all come from https://hyperperps.app/mcp when you connect, so new fields and markets reach you without updating the plugin.

Support

Anonymized market data. Not financial advice.

License

MIT

No installation packages available.

Remote