这是什么？

一个 MCP（模型上下文协议）服务器，使 Claude、GPT 和自定义 AI 代理能够直接访问 Hyperliquid 上实时的 HIP-4 预测市场数据。这是首个针对预测市场的 MCP 服务器。

无需 API 密钥。直接连接到 Hyperliquid 的公共 API。

工具 (10)

工具	描述
`list_markets`	所有带有当前价格的活跃预测市场
`get_market_detail`	特定结果 ID 的详细信息
`get_market_summary`	包含概率、结算状态和已解析元数据的丰富概览
`get_orderbook`	结果方的 L2 订单簿（买单、卖单、价差）
`get_prices`	所有结果币种的当前中间价
`get_candles`	用于图表和分析的 OHLCV K 线数据
`get_recent_trades`	特定市场的最新交易
`get_user_fills`	钱包地址的交易历史
`get_open_orders`	钱包的挂单限价订单
`get_user_positions`	当前结果份额持仓和价值

快速入门

Claude Desktop

添加到您的 Claude Desktop 配置 (claude_desktop_config.json)：

{
  "mcpServers": {
    "liquidiction": {
      "command": "npx",
      "args": ["tsx", "/path/to/liquidiction-mcp/mcp-server.ts"]
    }
  }
}

重启 Claude Desktop，然后尝试：

"What are the current HIP-4 prediction market odds?"（当前的 HIP-4 预测市场赔率是多少？）
"Show me the orderbook for outcome 13"（显示结果 13 的订单簿）
"What positions does 0x1393...1869 hold?"（0x1393...1869 持有哪些仓位？）

Claude Code

claude mcp add liquidiction npx tsx /path/to/liquidiction-mcp/mcp-server.ts

独立运行

git clone https://github.com/Liquidiction/liquidiction-mcp.git
cd liquidiction-mcp
npm install
npm start

配置

环境变量	默认值	描述
`HL_API_URL`	`https://api.hyperliquid-testnet.xyz`	Hyperliquid API 端点

对于主网数据，请设置为 https://api.hyperliquid.xyz。

查询示例

市场赔率

"What are the odds on BTC above $71,566?"（BTC 价格高于 $71,566 的赔率是多少？）

使用 get_market_summary 获取所有市场，查找 BTC 市场，并返回当前概率。

订单簿分析

"Is there good liquidity on the Hypurr vs Usain Bolt market?"（Hypurr 对阵 Usain Bolt 的市场流动性好吗？）

使用 get_orderbook 检查买卖深度、价差和订单数量。

投资组合检查

"What are my positions and PnL?"（我的持仓和盈亏情况如何？）

使用 get_user_positions + get_user_fills 显示持仓和交易历史。

价格历史

"How has the HYPE prediction market moved in the last 24 hours?"（过去 24 小时内 HYPE 预测市场的走势如何？）

使用 get_candles 并设置 1 小时间隔来显示价格随时间的变化。

什么是 HIP-4？

HIP-4 (Hyperliquid Improvement Proposal 4) 引入了在 Hyperliquid 的 L1 订单簿引擎上原生运行的预测市场。主要特点：

二元结果（是/否），定价为 0-100 美分
完全抵押（无杠杆，无清算风险）
与永续合约和现货共享相同的基础设施
支持循环市场（15 分钟、1 小时、1 天周期）
通过链上预言机结算

高级 API (x402)

获取包含订单簿深度、成交量和元数据的增强数据：

GET https://testnet.liquidiction.xyz/api/premium/analytics

通过 Base Sepolia 上的 x402 USDC 微支付，按 $0.001/请求收费。

链接

应用: testnet.liquidiction.xyz
落地页: liquidiction.xyz
Twitter: @LiquidictionHL
Telegram: t.me/Liquidiction
构建于: Hyperliquid

许可证

MIT

Liquidiction