Skip to content
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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/velinxs--hyperperps-heatmap-plugin/badge.svg)](/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
  1. {
  2. "name": "hyperperps",
  3. "description": "HyperPerps plugins: free, live Hyperliquid market data for AI agents.",
  4. "owner": {
  5. "name": "HyperPerps",
  6. "url": "https://hyperperps.app"
  7. },
  8. "plugins": [
  9. {
  10. "name": "hyperperps-liquidation-heatmap",
  11. "source": "./",
  12. "description": "Hyperliquid liquidation heatmap and crypto heatmap (BTC, ETH, SOL, HYPE) via a remote MCP server. No API key."
  13. }
  14. ]
  15. }
README.md · README · 92 lines
  1. # Hyperliquid Liquidation Heatmap – Crypto Trading – by HyperPerps
  2. 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.
  3. - **Server:** `https://hyperperps.app/mcp` (Streamable HTTP, read-only)
  4. - **Tool:** `get_liquidation_heatmap`
  5. - **Markets:** BTC, ETH, SOL, HYPE
  6. - **Live chart:** [hyperperps.app/hyperliquid-liquidation-heatmap](https://hyperperps.app/hyperliquid-liquidation-heatmap)
  7. ## What you get
  8. 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.
  9. - **Liquidation clusters** — where longs (below price) and shorts (above price) get force-closed, with notional, wallet count and distance from price.
  10. - **Stop-loss pools and take-profit walls** — resting orders that act as fuel and as caps.
  11. - **Crowd positioning** — net open-interest lean, whales vs retail, trapped size, leverage, fresh money, cascade mass.
  12. Data is anonymized: clusters only, never per-wallet rows.
  13. ## Install
  14. **Claude Code**
  15. ```
  16. /plugin marketplace add velinxs/hyperperps-heatmap-plugin
  17. /plugin install hyperperps-liquidation-heatmap@hyperperps
  18. ```
  19. Or add only the MCP server:
  20. ```
  21. claude mcp add --transport http hyperperps https://hyperperps.app/mcp
  22. ```
  23. **Claude.ai / Claude Desktop:** Settings → Connectors → Add custom connector → `https://hyperperps.app/mcp`.
  24. **Cursor, Windsurf, VS Code and other MCP clients:**
  25. ```json
  26. {
  27. "mcpServers": {
  28. "hyperperps": { "url": "https://hyperperps.app/mcp" }
  29. }
  30. }
  31. ```
  32. ## Tool
  33. `get_liquidation_heatmap`
  34. | Argument | Required | Meaning |
  35. |---|---|---|
  36. | `symbol` | yes | Market, e.g. `BTC`, `ETH`, `SOL`, `HYPE` |
  37. | `range` | no | Percent from price to include, e.g. `25`, or `all` |
  38. | `levels` | no | Walls per side, biggest first, e.g. `50`, or `all` |
  39. Default: walls within 5% of price, the biggest per side.
  40. `get_heatmap_field_definitions` (no arguments) returns what every field means.
  41. Example prompts:
  42. - "Where are the biggest BTC liquidation clusters right now?"
  43. - "Show ETH stop-loss pools within 10% of price."
  44. - "Is the HYPE crowd long or short, and how much of it is underwater?"
  45. - "Give me SOL's full liquidation ladder."
  46. ## HTTP API
  47. The same data without MCP:
  48. ```
  49. curl https://hyperperps.app/api/public/heatmap/BTC
  50. ```
  51. Field definitions: `https://hyperperps.app/api/public/heatmap`, or the `get_heatmap_field_definitions` tool.
  52. ## Always current
  53. 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.
  54. ## Support
  55. - Issues: [GitHub issues](https://github.com/velinxs/hyperperps-heatmap-plugin/issues)
  56. - Discord: https://discord.gg/KWKK6Nfpy8
  57. - Privacy: https://hyperperps.app/privacy · Terms: https://hyperperps.app/terms
  58. Anonymized market data. Not financial advice.
  59. ## License
  60. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.