一台MCP服务器，提供来自Hyperliquid犯罪者DEX的实时数据和洞察，供机器人、仪表盘和分析使用。

特色

• 用户数据查询：

• get_user_state：获取用户持仓、保证金和可提取余额，适用于永恒期或现货市场。

• get_user_open_orders：检索用户账户的所有未结订单。

• get_user_trade_history：获取交易记录，包含符号、价格和价格等详细信息。

• get_user_funding_history：查询可自定义时间范围的资金支付历史。

• get_user_fees：获取用户特定的费用结构（制作者/接受者费率）。

• get_user_staking_summary 和 get_user_staking_rewards：访问质押详情和奖励。

• get_user_order_by_oid 和 get_user_order_by_cloid：通过订单ID或客户订单ID获取特定订单详情。

• get_user_sub_accounts：列出与主账户关联的子账户。

• 市场数据工具：

• get_all_mids：获得所有交易对的中价。

• get_l2_snapshot：获取特定币种的二级订单簿快照。

• get_candles_snapshot：检索可自定义区间和时间范围的烛台数据。

Hyperliquid Info MCP Server

An MCP server that provides real-time data and insights from the Hyperliquid perp DEX for use in bots, dashboards, and analytics.

Features

• User Data Queries:

  • get_user_state: Fetch user positions, margin, and withdrawable balance for perpetuals or spot markets.
  • get_user_open_orders: Retrieve all open orders for a user account.
  • get_user_trade_history: Get trade fill history with details like symbol, size, and price.
  • get_user_funding_history: Query funding payment history with customizable time ranges.
  • get_user_fees: Fetch user-specific fee structures (maker/taker rates).
  • get_user_staking_summary & get_user_staking_rewards: Access staking details and rewards.
  • get_user_order_by_oid & get_user_order_by_cloid: Retrieve specific order details by order ID or client order ID.
  • get_user_sub_accounts: List sub-accounts associated with a main account.

• Market Data Tools:

  • get_all_mids: Get mid prices for all trading pairs.
  • get_l2_snapshot: Fetch Level 2 order book snapshots for a specific coin.
  • get_candles_snapshot: Retrieve candlestick data with customizable intervals and time ranges.
  • get_coin_funding_history: Query funding rate history for a specific coin.
  • get_perp_dexs: Fetch metadata about perpetual markets (using meta).
  • get_perp_metadata & get_spot_metadata: Get detailed metadata for perpetual and spot markets, with optional asset contexts.

• Analysis Prompt:

  • analyze_positions: A guided prompt to analyze user trading activity using relevant tools.

• ISO 8601 Support: Time-based queries (get_candles_snapshot, get_coin_funding_history, get_user_funding_history) accept ISO 8601 time strings for precise data filtering.

Installation

Prerequisites

• Python 3.10: Required by the Hyperliquid Python SDK.
• A valid Hyperliquid account address for user-specific queries.
• uv or pip for package management.

Steps

1. Clone the Repository:

   git clone https://github.com/kukapay/hyperliquid-info-mcp.git
   cd hyperliquid-info-mcp
   

2. Install Dependencies: Using uv:

   uv sync
   

Usage

Running the Server

Run the server in development mode with MCP Inspector:

mcp dev main.py

Or install it for use in Claude Desktop:

mcp install main.py --name "Hyperliquid Info"

Example Usage

Using the MCP Inspector or Claude Desktop, you can interact with the server using natural language prompts. Below are examples of how to trigger the analyze_positions prompt and individual tools conversationally.

1. Analyze Trading Positions: