봇, 대시보드 및 분석에서 사용할 Hyperliquid perp DEX의 실시간 데이터 및 통찰력을 제공하는 MCP 서버.

특징

• 사용자 데이터 쿼리:

• get_user_state: Fetch 사용자 위치, 마진 및 영구 또는 스팟 시장에 대한 인출 가능한 균형.

• get_user_open_orders: 사용자 계정의 모든 오픈 주문 검색.

• get_user_trade_history: 기호, 크기 및 가격과 같은 세부 사항으로 거래 채우 내역을 얻으십시오.

• get_user_funding_history: Query funding payment history 와 customizable time ranges.

• get_user_fees: Fetch 사용자 별 수수료 구조 (maker/taker Rate).

• get_user_staking_summary & get_user_staking_rewards: 액세스 검색 및 보상.

• get_user_order_by_oid & get_user_order_by_cloid]: 주문 ID 또는 클라이언트 주문 ID로 특정 주문 세부 정보를 검색합니다.

• [T9]]: 메인 계정과 관련된 하위 계정 목록.

• ** 시장 데이터 도구**:

• [T10]]: 모든 거래 쌍에 대한 중간 가격을 가져옵니다.

• get_l2_snapshot: 특정 동전에 대한 Fetch Level 2 주문 책 스냅 샷.

• [T12]]: customizable 간격과 시간 범위를 가진 촛대 자료를 만회하십시오.

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: