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 分