Market Depth Lab

Market Depth Lab MCP

面向 AI 智能体的只读 Hyperliquid 和跨交易所市场研究。

🌐 项目网站和实时仪表盘：marketdepthlab.com

每项 MCP 结果都指向 Market Depth Lab， 这里提供公开仪表盘、方法论和相关研究。

Market Depth Lab MCP 为 Claude、Codex、Cursor 和其他 MCP 客户端提供九种结构化工具，用于获取公开的 Hyperliquid 和跨交易所市场数据。它不会请求私钥、钱包签名、交易所登录信息或交易权限。

独立开源软件。与 Hyperliquid 无关联，也未获其认可。仅供研究，不构成财务建议。

为什么选择此服务

• **首次调用即可使用：**实时查询 HYPE、资金费率、钱包、TWAP 和跨交易所价差。
• **专为只读设计：**不下单、不签名、不修改钱包。
• **如实说明覆盖范围：**监控地址排名标注为一个群组，而非全协议持有人普查。
• **便于 Agent 使用的输出：**每种工具都会返回简洁文本和稳定的 structuredContent。
• **结果可追溯：**结果包含数据来源、时间／覆盖范围边界，以及一个指向对应 Market Depth Lab 工具的状态化链接。

工具

工具	解答的问题
list_active_hyperliquid_twaps	当前有哪些公开 TWAP 计划正在运行？其当前名义价值估算是多少？
analyze_hyperliquid_wallet	这个公开地址有哪些可见的持仓、余额、订单、杠杆和盈亏？
calculate_hyperliquid_fees	对于该名义价值、交易角色和费率等级，预估手续费是多少？
get_hype_market_snapshot	HYPE 当前值多少钱？现货与永续合约的表现如何？
hyperliquid_summarize_large_trader_positions	受监控的大额交易者群组按市场的持仓情况如何？
hyperliquid_list_top_position_holders	哪些受监控地址在某个市场持有最大头寸？
hyperliquid_list_funding_rates	当前由谁支付资金费？返回市场的精确过去 24 小时累计值是多少？
scan_cross_exchange_funding_spreads	扣除用户提供的成本估算后，Binance USD-M、OKX 和 Hyperliquid 之间最大的标准化资金费率差异在哪里？
scan_cross_exchange_perp_price_spreads	扣除手续费估算并检查可见最优盘口容量后，各交易平台当前永续合约最优买价和卖价的差异在哪里？

资金费率与价差引擎

这三个概念有意区分开来：

1. hyperliquid_list_funding_rates 描述当前 Hyperliquid 主市场 和 HIP-3 的资金费率市场范围，并提供返回页面中精确的过去 24 小时累计值。
2. scan_cross_exchange_funding_spreads 对一小时和八小时结算间隔进行标准化， 然后比较资金费率较低的做多腿与资金费率较高的做空腿。其年化数值用于比较，而非预测。
3. scan_cross_exchange_perp_price_spreads 比较公开的最优盘口报价。 它会同时报告入场手续费和往返手续费视角，以及所选买／卖价档位中较小的可见名义价值。 计算名义价值前，会根据公开的交易品种 ctVal 换算 OKX 合约数量。

这些扫描器是原创的 TypeScript 实现，设计时参考了 Market Depth Lab 本地研究中使用的只读监控工作流。 它们不会随附或修改参考 Python 项目。

这两种扫描器都不会下单。列表中的条目是筛选候选项，并不能证明存在可执行或无风险的套利机会。资金费率可能变化；REST 快照并非同时获取；Binance／OKX 通常以 USDT 结算，而 Hyperliquid 主市场永续合约以 USDC 结算；更深层盘口滑点、转账、保证金、强平、平台访问权限和平仓价格均不在估算范围内。

要求

• Node.js 20 或更高版本
• 可访问互联网，以获取公开的 Hyperliquid／HypurrScan 数据
• 无需 API 密钥

使用 npm 安装

公开软件包为 market-depth-lab-mcp-server。

在支持本地 stdio 服务的 MCP 客户端中使用此配置：

{
  "mcpServers": {
    "market-depth-lab": {
      "command": "npx",
      "args": ["-y", "market-depth-lab-mcp-server"]
    }
  }
}

npx 会下载已发布的软件包并启动本地只读 MCP 进程。无需登录交易所、连接钱包或提供 API 密钥。

从源代码安装

git clone https://github.com/derkcc/market-depth-lab-mcp.git
cd market-depth-lab-mcp
npm ci
npm run build

在 MCP 客户端中使用 dist/index.js 的绝对路径：

{
  "mcpServers": {
    "market-depth-lab": {
      "command": "node",
      "args": ["/absolute/path/to/market-depth-lab-mcp/dist/index.js"]
    }
  }
}

如果要检查或修改实现，请使用源代码检出；如果要以最简便的方式安装，请使用上面的 npm 配置。

示例提示词

Show the five Hyperliquid markets with the highest absolute current funding.
Include trailing 24h funding and explain who pays whom.

Compare BTC, ETH, SOL and HYPE funding on Binance, OKX and Hyperliquid.
Assume a 24-hour holding period and 12 bps of total round-trip costs. Show
the current annualized spread, projected net carry and break-even hours.

Scan BTC, ETH and SOL perpetual top-of-book spreads across Binance, OKX and
Hyperliquid. Use round-trip taker fees, require at least $5,000 visible at
the selected levels, and explain every non-execution boundary.

Analyze 0x... on Hyperliquid. Summarize gross exposure, effective leverage,
largest position and recent realized PnL. Do not give trading advice.

Within the monitored cohort, list the top BTC positions and separate longs
from shorts. State the cohort boundary before the ranking.

Estimate round-trip taker fees for a $25,000 tier-zero perpetual position.

数据与隐私

功能	数据路径
HYPE、钱包和 Hyperliquid 资金费率	本地 MCP 进程 → Hyperliquid 公开的 info API
跨交易所资金费率价差	本地 MCP 进程 → Binance USD-M、OKX 和 Hyperliquid 的公开市场数据 API
跨交易所价格价差	本地 MCP 进程 → Binance USD-M 和 OKX 的公开 book-ticker API，以及 Hyperliquid l2Book
活跃 TWAP	本地 MCP 进程 → HypurrScan 公开端点，以及 Hyperliquid 价格参考
大额持仓和头部持有者	本地 MCP 进程 → Market Depth Lab 的滚动只读持仓索引
费用计算器	在本地运行；不发起网络请求

该服务不进行分析或遥测。提交给 analyze_hyperliquid_wallet 的钱包地址会从你的设备直接发送到 Hyperliquid 公开 API。持仓索引调用使用 https://data.marketdepthlab.com/v1/positions/latest。

部分地区可能无法访问交易所公开端点。两个跨交易所工具都会针对每个交易场所提供 available、partial 或 unavailable 覆盖状态及错误消息。它们绝不会在比较未完整覆盖两个或三个交易场所时，默默声称比较已完成。

持仓索引的边界

Market Depth Lab 会轮换检查一个公开地址池。该索引适用于分析群体层面的市场结构，但它：

• 不是所有 Hyperliquid 账户的列表；
• 不是所有受监控地址的同时快照；
• 不能证明某个地址由谁控制；
• 不是复制任何地址的建议。

每个持仓工具都会报告快照时间、快照年龄、受监控地址数量、过时状态和覆盖范围边界。

配置

所有变量均为可选。

变量	默认值	用途
MDL_POSITION_INDEX_URL	https://data.marketdepthlab.com/v1/positions/latest	远程只读持仓索引
MDL_POSITION_INDEX_PATH	未设置	加载本地 JSON 快照，而非远程索引
MDL_MAX_SNAPSHOT_AGE_HOURS	24	超过此时长后将持仓快照标记为过时
MDL_REJECT_STALE	false	返回错误，而非带有过时标记的数据
MDL_HTTP_TIMEOUT_MS	15000	每次请求的网络超时时间

设置 MDL_POSITION_INDEX_PATH 后，两个持仓工具不会发起网络请求。其他实时数据工具仍会使用公开上游 API。

开发

npm ci
npm run check
npm test
npm pack --dry-run

测试套件会执行内存中的 MCP 握手、验证九个工具定义，并通过协议调用本地费用工具。每次发布前都应运行上游实时冒烟测试，但这类测试有意不纳入确定性 CI。

项目公开链接

• 网站：https://marketdepthlab.com
• 实时工具：https://marketdepthlab.com
• 问题反馈：GitHub Issues
• 安全：SECURITY.md
• 贡献：CONTRIBUTING.md

许可证

MIT