Hydromancer

io.github.joshavenue由 GitHub 帳號 joshavenue 發布v0.2.1更新於 Nov 7, 2026

Read-only Hyperliquid data: wallets, top traders, markets, funding and liquidations.

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

透過 Hydromancer API 提供唯讀的 Hyperliquid 資料,讓助理查看錢包持倉、交易者排行、行情、資金費率與爆倉資訊。

可以做什麼
  • 檢視錢包:概覽、持倉、成交、已平倉交易、掛單、轉帳與資金費率
  • 批次比較最多 1000 個錢包,並依收益、勝率或成交量篩選頂尖交易者
  • 讀取行情:快照、K 線、資金費率、未平倉合約、爆倉、盤口深度與滑價
  • 列出市場與 HIP-3 交易所、已結算預測市場以及 builder 應用活動
  • 送出任意 Hydromancer info 請求,並查詢自己的 API 用量
適用情境
適合想用自然語言了解 Hyperliquid 交易狀況時使用,例如評估某個錢包的交易能力、找出穩定的獲利交易者、查看資金費率或未平倉合約趨勢,或估算某筆交易的滑價,而不必自行撰寫 API 程式碼。
執行需求
透過 npx 以 stdio 在本機執行,需要 Node.js 20 或更新版本。需在 HYDROMANCER_API_KEY 環境變數中提供 Hydromancer API 金鑰。選用設定包括基礎位址(僅接受主網或測試網主機)、逾時與結果長度上限。需要能連線至 Hydromancer API 的網路。
安裝前請注意
每次工具呼叫都會消耗 Hydromancer 方案中的 token,因此會產生費用,可用用量工具查看。API 金鑰會從應用程式設定讀取並傳送至 Hydromancer API 主機。此伺服器為唯讀,無法下單、取消或簽署,也不接觸資金或私鑰。查詢的錢包位址會傳送給 Hydromancer。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Hydromancer,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Hydromancer MCP

Ask your AI about Hyperliquid in plain English, using live data from the Hydromancer API.

Disclosure: this package is maintained by the Hydromancer team. You need a Hydromancer API key to use it.

"What is this wallet holding, and is it a good trader?" "Who were the best traders this week, without bots?" "Who got liquidated in the last 6 hours?" "How much BTC can I sell before the price moves 0.5%?"

Your AI picks the right tool, calls Hydromancer and explains the answer. You don't need to read API docs, write code or work out timestamps.

  • 19 read-only tools: wallets, trades, top traders, markets, liquidations, builders, prediction markets
  • Works with any MCP app: Claude Desktop, Claude Code, Cursor, Codex, VS Code (Copilot), Gemini CLI, Windsurf, Cline and others
  • Friendly inputs: coin names in any case (btc, $ETH, ETH-PERP, xyz:tsla), times like 24h, 7d or 2026-10-01
  • Safe: read-only. It cannot place, cancel or sign orders, and it never touches funds or private keys
  • Your key stays local: it is read from your app's settings and never sent anywhere except api.hydromancer.xyz (or api-testnet.hydromancer.xyz if you set it)

1. Get a Hydromancer API key

See Get API keys. Early-stage teams may qualify for free access.

2. Add it to your AI app

You need Node.js 20 or newer. Replace YOUR_KEY with your key.

Claude Desktop

Settings → Developer → Edit Config, then add:

json
{  "mcpServers": {    "hydromancer": {      "command": "npx",      "args": ["-y", "hydromancer-mcp"],      "env": { "HYDROMANCER_API_KEY": "YOUR_KEY" }    }  }}

Restart Claude Desktop.

Claude Code

bash
claude mcp add hydromancer -e HYDROMANCER_API_KEY=YOUR_KEY -- npx -y hydromancer-mcp

Cursor

~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project): use the same mcpServers block as Claude Desktop.

Codex

~/.codex/config.toml:

toml
[mcp_servers.hydromancer]command = "npx"args = ["-y", "hydromancer-mcp"]env = { HYDROMANCER_API_KEY = "YOUR_KEY" }

VS Code (GitHub Copilot)

.vscode/mcp.json:

json
{  "servers": {    "hydromancer": {      "command": "npx",      "args": ["-y", "hydromancer-mcp"],      "env": { "HYDROMANCER_API_KEY": "YOUR_KEY" }    }  }}

From a local copy

bash
git clone https://github.com/joshavenue/Hydromancer-MCP && cd Hydromancer-MCPnpm install && npm run build

Then use "command": "node" and "args": ["/full/path/to/Hydromancer-MCP/dist/index.js"].

3. Ask

Try:

  • Give me an overview of wallet 0x… and tell me if it's a good trader.
  • Show the top 10 traders by profit over the last 7 days, no bots, then what the top 3 hold right now.
  • Which of these wallets have more than $1M: 0x…, 0x…, 0x…?
  • Who got liquidated on Hyperliquid in the last 6 hours? Longs or shorts?
  • BTC, ETH and HYPE: price, 24h volume and open interest.
  • Has ETH open interest been rising or falling today?
  • What's the BTC funding rate averaged over the last week, annualized?
  • How much did builder 0x… earn in fees in the last hour?

Tools

ToolWhat it answers
hydromancer_wallet_overviewBalance (correct for unified-account and portfolio-margin wallets), account mode, open positions (entry, liquidation price, leverage, PnL), spot balances, trading record, bot score
hydromancer_compare_walletsUp to 1,000 wallets at once, with balance and account mode, sorted by balance
hydromancer_wallet_tradesFills in a time window, with volume, PnL, fees and per-coin totals
hydromancer_wallet_closed_tradesRound-trip trades: win rate, net PnL, hold time, best coin
hydromancer_wallet_open_ordersResting limits, stop-losses, take-profits
hydromancer_wallet_transfersDeposits, withdrawals, sends, vault moves, liquidations
hydromancer_wallet_fundingFunding paid or received, per coin
hydromancer_top_tradersLeaderboard by profit, win rate or volume, with bot and activity filters
hydromancer_market_snapshotPrice, 24h volume and open interest (max leverage in the top-markets list)
hydromancer_price_historyCandles from 1 second to 1 month (including 15s and 30s)
hydromancer_funding_historyFunding rates, average and annualized
hydromancer_open_interest_historyOpen interest trend, 1 minute to 1 month buckets
hydromancer_recent_liquidationsLiquidations by market, with long/short totals
hydromancer_market_depthOrder book depth and slippage for a trade size
hydromancer_list_marketsEvery market, HIP-3 exchanges, search by name or category
hydromancer_builder_activityVolume, users and fees for a builder app
hydromancer_prediction_marketsSettled HIP-4 prediction markets
hydromancer_my_usageYour own API usage and tokens
hydromancer_raw_requestAny other Hydromancer /info request

The server also provides a hydromancer_guide prompt and a hydromancer://guide resource that tell the AI which tool to use for which question.

Settings

VariableDefaultPurpose
HYDROMANCER_API_KEY(required)Your API key
HYDROMANCER_BASE_URLhttps://api.hydromancer.xyz/infoAPI endpoint. Only the mainnet and testnet Hydromancer hosts are accepted.
HYDROMANCER_TIMEOUT_MS30000Request timeout
HYDROMANCER_MAX_RESULT_CHARS40000Cap on one tool result, so the AI is not flooded

Good to know

  • Each tool call uses your Hydromancer plan's tokens, like any API request. Check usage with hydromancer_my_usage.
  • Mainnet only. HIP-3 markets use a prefix, for example xyz:TSLA.
  • Balances: unified-account and portfolio-margin wallets keep their money in spot, so balanceUsd uses their spot stablecoins. Other spot tokens are listed but not priced.
  • Times are UTC. Some endpoints cap a single request (for example 2,000 fills); the tool says so when it happens.

Development

bash
npm installnpm run buildnpm test                                   # offline unit testsHYDROMANCER_API_KEY=... npm run smoke      # calls every tool against the live API

From the Hydromancer blog

Guides and research on getting and using Hyperliquid data:

License

MIT

來源:README.md,提交 4dbf08b

工具

19

hydromancer_wallet_overview

Wallet overview: balance, open positions, PnL record

One-call profile of any Hyperliquid wallet: account value, every open perp position (side, size, entry, liquidation price, leverage, unrealized PnL), spot balances and its realized trading record (PnL, win rate, trade count, volume, human score). Use this first for questions like "what is this wallet holding?" or "is this trader any good?". Set includeHip3=true to include HIP-3 markets such as xyz:TSLA.

輸入參數address必填includeHip3

hydromancer_compare_wallets

Compare many wallets at once

Look up balance, account mode and open positions for up to 1,000 wallets (100 when includeHip3=true), sorted by balance. Handles unified-account and portfolio-margin wallets, whose money sits in spot rather than perps. Use for watchlists: "which of these wallets are whales?", "what do these 50 traders hold?".

輸入參數addresses必填includeHip3minBalanceUsd

hydromancer_wallet_trades

Wallet trade history (fills)

Every fill (buy/sell execution) a wallet made in a time window, newest first, with totals: volume, realized PnL, fees and a per-coin breakdown. since/until accept Relative ("30m", "6h", "24h", "7d"), a date ("2026-10-01"), a date-time ("2026-10-01T12:00:00Z"), "now", or Unix ms. Default window: last 24h. Large orders split into many fills are merged by default.

輸入參數coinlimitsinceuntiloffsetaddress必填mergeSplitOrders

hydromancer_wallet_closed_trades

Wallet closed trades (open-to-close round trips)

Completed trades for a wallet: each row is a full position from open to close with entry, exit, size, gross and net PnL, fees, funding and how long it was held. Best tool for judging trading skill ("what is this wallet's win rate and best coin?"). Default window: last 30 days. since/until accept Relative ("30m", "6h", "24h", "7d"), a date ("2026-10-01"), a date-time ("2026-10-01T12:00:00Z"), "now", or Unix ms.

輸入參數coinlimitsinceuntiladdress必填

hydromancer_wallet_open_orders

Wallet open orders (limits, stop-losses, take-profits)

All resting orders for a wallet right now, including stop-loss and take-profit triggers. Shows where a trader plans to buy, sell or exit.

輸入參數address必填

hydromancer_wallet_transfers

Wallet deposits, withdrawals, transfers and liquidations

Money movements for a wallet: deposits, withdrawals, sends, spot/perp transfers, vault deposits and liquidations. Default window: last 30 days. since/until accept Relative ("30m", "6h", "24h", "7d"), a date ("2026-10-01"), a date-time ("2026-10-01T12:00:00Z"), "now", or Unix ms.

輸入參數limitsinceuntiladdress必填

hydromancer_wallet_funding

Wallet funding payments

Funding paid or received by a wallet's open positions, hour by hour, with totals per coin. Positive = received, negative = paid. Default window: last 7 days.

輸入參數sinceuntiladdress必填

hydromancer_top_traders

Top traders leaderboard

Rank Hyperliquid traders by realized profit, win rate or volume over 1 day to all time, with filters that remove bots and one-off wallets. Use for "who are the best traders this week?", "find consistent winners on stocks (dex xyz)" or "top traders using builder X". Pair with hydromancer_wallet_overview to see what they hold now.

輸入參數limitmarketoffsetperiodrankBybuilderminTradesexcludeBotsminDaysActive

hydromancer_market_snapshot

Live price, volume and open interest for markets

Current mark/oracle/mid price, 24h volume and open interest (in coins and USD) for one or more markets. The top-markets list also shows max leverage. Leave coins empty for the top markets by 24h volume. Works for HIP-3 markets (e.g. "xyz:TSLA").

輸入參數topcoins

hydromancer_price_history

Price candles (OHLCV)

Price history as candles (open, high, low, close, volume) for any market. Intervals from 1 second to 1 month. Default: 1h candles for the last 24h. since/until accept Relative ("30m", "6h", "24h", "7d"), a date ("2026-10-01"), a date-time ("2026-10-01T12:00:00Z"), "now", or Unix ms.

輸入參數coin必填sinceuntilinterval

hydromancer_funding_history

Funding rate history for a market

Hourly funding rates for a market over time, with the average and annualized rate. Positive funding means longs pay shorts. Default window: last 7 days.

輸入參數coin必填sinceuntil

hydromancer_open_interest_history

Open interest history

How open interest (total open positions) in a market changed over time, in coins and USD. Rising OI with rising price usually means new longs; falling OI means positions are closing. Default: hourly for the last 24h.

輸入參數coin必填sinceuntilinterval

hydromancer_recent_liquidations

Recent liquidations

Positions that were force-closed (liquidated), newest first, for one market or the whole exchange, with totals by side. "Long liquidated" means a long position was wiped out. Default window: last 24h.

輸入參數coinlimitsinceuntil

hydromancer_market_depth

Order book depth and slippage

How much can be bought or sold near the current price. Returns USD depth on each side within 0.1% to 2% of the price for a market, plus the expected slippage for a market order of a given size over time.

輸入參數coin必填sinceorderSizeUsd

hydromancer_list_markets

List every market and HIP-3 exchange

Lists every tradable perp market, optionally filtered by search text or category (crypto, stocks, indices, commodities, fx), plus the HIP-3 exchanges (perp DEXs) that list stocks and other assets. Use when unsure of a market's exact name.

輸入參數limitsearchcategory

hydromancer_builder_activity

Builder app activity (trades routed through an app)

Fills routed through a builder (a trading app such as MetaMask, Phantom or a Telegram bot) by its builder address, with volume, builder fees earned, unique traders and top coins. Default window: last 1h (busy builders produce thousands of fills). since/until accept Relative ("30m", "6h", "24h", "7d"), a date ("2026-10-01"), a date-time ("2026-10-01T12:00:00Z"), "now", or Unix ms.

輸入參數limitsinceuntilbuilder必填

hydromancer_prediction_markets

Prediction markets (HIP-4 outcomes)

Settled Hyperliquid prediction markets (HIP-4 outcomes) with their result and trading stats, searchable by text, underlying asset or category.

輸入參數limitsearchcategoryunderlying

hydromancer_my_usage

My Hydromancer API usage

Your own Hydromancer API usage by day and request type: requests, failures, speed and billable tokens. Use to check how much of your plan you are using.

輸入參數days

hydromancer_raw_request

Advanced: any Hydromancer API request

Send any Hydromancer /info request directly, for endpoints the other tools do not cover (e.g. vaultSummaries, historicalOrders, spotMeta, outcomeMeta, delegations, perpDexStatus). Pass the request body as JSON including "type". Full list: https://docs.hydromancer.xyz/llms.txt . Read-only: this server never places orders.

輸入參數body必填limit

版本歷史

1
  1. v0.2.1最新Oct 31, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分