Skip to content
Sign inWatchGet whale alertsFollow the whalesAlerts
All guidesDevelopers

ReferenceDevelopers

Whale data in your assistant and your code.

Ask Claude, ChatGPT or Cursor what Hyperliquid whales hold, and get the figure with its time and a line to quote. The MCP server and the public JSON are free and need no key.

On this page8 sections
  1. The MCP server
  2. Connect
  3. The five tools
  4. What every answer carries
  5. Limits
  6. Public JSON and feeds
  7. Licence and citing
  8. Privacy

The MCP server

Address: https://whaleradar.com/mcp

  • Streamable HTTP, read only. No account, no key, no session.
  • Speaks MCP 2026-07-28 and the earlier 2025-11-25, 2025-06-18, 2025-03-26.
  • Five tools that answer with what the public pages show: positions, liquidations, the Whale Tide, single whales and the day’s findings.

Connect

Claude. Open Settings, then Connectors, choose Add custom connector and paste the address. In Claude Code:

claude mcp add --transport http whaleradar https://whaleradar.com/mcp

ChatGPT. Turn on developer mode in Settings under Apps and Connectors, then create a connector with the address and no authentication.

Cursor. Add the server to .cursor/mcp.json:

{
  "mcpServers": {
    "whaleradar": {
      "url": "https://whaleradar.com/mcp"
    }
  }
}

VS Code. Add it to .vscode/mcp.json:

{
  "servers": {
    "whaleradar": {
      "type": "http",
      "url": "https://whaleradar.com/mcp"
    }
  }
}

Gemini CLI. Add it to ~/.gemini/settings.json:

{
  "mcpServers": {
    "whaleradar": {
      "httpUrl": "https://whaleradar.com/mcp"
    }
  }
}

In an API. Model APIs that take a remote MCP server as a tool, such as OpenAI’s Responses API or xAI’s API for Grok, take the address as server_url in tools:

{
  "type": "mcp",
  "server_label": "whaleradar",
  "server_url": "https://whaleradar.com/mcp"
}

Any other client that speaks Streamable HTTP connects with the address alone. The server card is at /mcp/server-card.

The five tools

  • market: One market: the price, whale money long and short with each side’s share, the largest positions with leverage, entry and liquidation price.
  • whale_tide: The Whale Tide for all markets, an asset class or one market, with yesterday, a week and a month ago, the 52-week range and up to 30 daily closes.
  • liquidations: Whale liquidations of the last 24 hours and the 30 whale positions closest to liquidation at the live price.
  • whale: One whale by name, slug or address: track record, account, open positions and its moves of the last 7 days.
  • today: What matters most today, in a few lines, with links to the answer and the daily report.

Ask in plain words, for example “How are whales positioned in BTC?”, “Who is closest to liquidation?” or “What is the Whale Tide for gold?”. The assistant picks the tool.

What every answer carries

  • The time of its data in UTC, and a link to the page that shows it.
  • A citation line in English, Chinese and Korean, ready to quote, for example: Whale Tide, all markets: 24 (strongly short), 23 Oct 2026, 19:45 UTC. Source: WhaleRadar, whaleradar.com/tide
  • The source: WhaleRadar, from the Hyperliquid blockchain.
  • Not financial advice. The answers describe positions and never tell anyone to trade.

Each answer comes as short text for the assistant and as data with the same fields, so a client can show the figures and the line to quote.

Limits

  • 60 requests a minute per network. Past that, the server answers 429 until the minute is over.
  • 5,000 requests a day per network. Past that, the server answers 429 until 00:00 UTC.
  • When many ask at once, a tool can answer that it is busy. Ask again a minute later.
  • Moves and liquidations appear 15 minutes after they happen, as on the free pages. Positions are as current as on the site.
  • The Whale Tide’s daily closes reach back 30 days, a whale’s moves 7 days from $1M, the list near liquidation the closest 30.

Live data, whole datasets, long history and the right to build a product on the data come with Desk.

Public JSON and feeds

The same figures as files, free, without a key, with CORS for browsers. Every answer carries attribution and a cite line.

For a feed reader, an aggregator or a newsroom’s wire tool, as Atom feeds:

  • /feed.xml: the daily reports and the event pages, newest first

Licence and citing

Quote any figure with its time and a link. The Whale Tide and the monthly CSV tables are CC BY 4.0: credit “Whale Tide by WhaleRadar” or “Source: WhaleRadar” with a link. Everything else: “Source: WhaleRadar” with a link. More on the press page and in the terms.

Privacy

The MCP server stores no questions and sets no cookie. An answer is kept for up to five minutes, without any link to who asked. For the limit it counts requests per network in memory only and drops the count soon after its minute ends. To see how it is used, it counts connections and tool calls by tool, kind of app and country, never the IP address, the question or the answer. Privacy policy.