Back to search
hyperperps
MarketplaceWorks with Claude CodeGitHub
HyperPerps plugins: free, live Hyperliquid market data for AI agents.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/velinxs--hyperperps-heatmap-plugin)HTML
<a href="/listings/velinxs--hyperperps-heatmap-plugin"><img src="/api/listings/velinxs--hyperperps-heatmap-plugin/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**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" }
}
}What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 15 lines
- {
- "name": "hyperperps",
- "description": "HyperPerps plugins: free, live Hyperliquid market data for AI agents.",
- "owner": {
- "name": "HyperPerps",
- "url": "https://hyperperps.app"
- },
- "plugins": [
- {
- "name": "hyperperps-liquidation-heatmap",
- "source": "./",
- "description": "Hyperliquid liquidation heatmap and crypto heatmap (BTC, ETH, SOL, HYPE) via a remote MCP server. No API key."
- }
- ]
- }
README.md · README · 92 lines
- # 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.
- - **Server:** `https://hyperperps.app/mcp` (Streamable HTTP, read-only)
- - **Tool:** `get_liquidation_heatmap`
- - **Markets:** BTC, ETH, SOL, HYPE
- - **Live chart:** [hyperperps.app/hyperliquid-liquidation-heatmap](https://hyperperps.app/hyperliquid-liquidation-heatmap)
- ## 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:**
- ```json
- {
- "mcpServers": {
- "hyperperps": { "url": "https://hyperperps.app/mcp" }
- }
- }
- ```
- ## Tool
- `get_liquidation_heatmap`
- | Argument | Required | Meaning |
- |---|---|---|
- | `symbol` | yes | Market, e.g. `BTC`, `ETH`, `SOL`, `HYPE` |
- | `range` | no | Percent from price to include, e.g. `25`, or `all` |
- | `levels` | no | Walls 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
- - Issues: [GitHub issues](https://github.com/velinxs/hyperperps-heatmap-plugin/issues)
- - Discord: https://discord.gg/KWKK6Nfpy8
- - Privacy: https://hyperperps.app/privacy · Terms: https://hyperperps.app/terms
- Anonymized market data. Not financial advice.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.