¿Qué es esto?

Un servidor MCP (Model Context Protocol) que brinda a agentes de IA como Claude, GPT y agentes personalizados acceso directo a datos en tiempo real de mercados de predicción HIP-4 en Hyperliquid. Este es el primer servidor MCP para mercados de predicción.

No se requieren claves API. Se conecta directamente a la API pública de Hyperliquid.

Herramientas (10)

Herramienta	Descripción
`list_markets`	Todos los mercados de predicción activos con precios actuales
`get_market_detail`	Información detallada para un ID de resultado específico
`get_market_summary`	Resumen completo con probabilidades, estado de liquidación y metadatos analizados
`get_orderbook`	Libro de órdenes L2 (ofertas, demandas, diferencial) para un lado del resultado
`get_prices`	Precios medios actuales para todas las monedas de resultado
`get_candles`	Datos de velas OHLCV para gráficos y análisis
`get_recent_trades`	Últimas operaciones en un mercado específico
`get_user_fills`	Historial de operaciones para una dirección de billetera
`get_open_orders`	Órdenes límite pendientes para una billetera
`get_user_positions`	Tenencias y valores actuales de acciones de resultados

Inicio rápido

Claude Desktop

Agrégalo a tu configuración de Claude Desktop (claude_desktop_config.json):

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

Reinicia Claude Desktop y luego intenta:

"¿Cuáles son las probabilidades actuales del mercado de predicción HIP-4?"
"Muéstrame el libro de órdenes para el resultado 13"
"¿Qué posiciones tiene 0x1393...1869?"

Claude Code

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

Ejecución independiente

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

Configuración

Variable de entorno	Predeterminado	Descripción
`HL_API_URL`	`https://api.hyperliquid-testnet.xyz`	Punto final de la API de Hyperliquid

Establece en https://api.hyperliquid.xyz para datos de la red principal (mainnet).

Consultas de ejemplo

Probabilidades de mercado

"¿Cuáles son las probabilidades de que BTC supere los $71,566?"

Utiliza get_market_summary para obtener todos los mercados, encuentra los mercados de BTC y devuelve las probabilidades actuales.

Análisis del libro de órdenes

"¿Hay buena liquidez en el mercado de Hypurr vs Usain Bolt?"

Utiliza get_orderbook para verificar la profundidad de oferta/demanda, el diferencial y el número de órdenes.

Verificación de cartera

"¿Cuáles son mis posiciones y PnL?"

Utiliza get_user_positions + get_user_fills para mostrar las tenencias y el historial de operaciones.

Historial de precios

"¿Cómo se ha movido el mercado de predicción HYPE en las últimas 24 horas?"

Utiliza get_candles con un intervalo de 1h para mostrar el movimiento del precio a lo largo del tiempo.

¿Qué es HIP-4?

HIP-4 (Hyperliquid Improvement Proposal 4) introduce mercados de predicción que funcionan de forma nativa en el motor de libro de órdenes L1 de Hyperliquid. Características clave:

Resultados binarios (Sí/No) con precios de 0 a 100 centavos
Totalmente colateralizado (sin apalancamiento, sin riesgo de liquidación)
Comparte la misma infraestructura que los perpetuos y spot
Admite mercados recurrentes (períodos de 15M, 1H, 1D)
Liquidación mediante oráculo en cadena

API Premium (x402)

Para datos enriquecidos con profundidad de libro de órdenes, volumen y metadatos:

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

Con pago por uso a $0.001/solicitud mediante micropagos USDC x402 en Base Sepolia.

Enlaces

App: testnet.liquidiction.xyz
Landing: liquidiction.xyz
Twitter: @LiquidictionHL
Telegram: t.me/Liquidiction
Construido sobre: Hyperliquid

Licencia

MIT

Liquidiction