convez.ai
MCP ServerFinanceiroIntermediário
Liquidiction

Liquidiction MCP Server

Liquidiction/liquidiction-mcp

Mercados de previsão Hyperliquid para agentes Claude e IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que oferece a agentes de IA acesso direto aos dados de mercados de previsão HIP-4 do Hyperliquid. Consulte odds ao vivo, livros de ofertas, velas de preço e posições sem necessidade de chaves de API.

Instalação

$npx convez-ai Liquidiction/liquidiction-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
3
Acompanhando
0
Saúde
50%
Último commit
há 2 meses
Versão
v1.0.0
Issues abertas
3
Contribuidores
1

Casos de uso

  • Análise de probabilidades em tempo real de mercados de previsão
  • Consultoria de liquidez e spread de orderbooks
  • Monitoramento de posições e histórico de trades em carteiras
  • Análise técnica com dados OHLCV de mercados de previsão

Veredito

MCP server bem estruturado e de nicho específico para mercados de previsão. Implementação clara com 10 ferramentas úteis, mas público-alvo é limitado a traders e researchers interessados em HIP-4 do Hyperliquid.

README

A tradução para o português deste README ainda está na fila.


What is this?

An MCP (Model Context Protocol) server that gives AI agents like Claude, GPT, and custom agents direct access to live HIP-4 prediction market data on Hyperliquid. This is the first MCP server for prediction markets.

No API keys required. Connects directly to Hyperliquid's public API.

Tools (10)

ToolDescription
list_marketsAll active prediction markets with current prices
get_market_detailDetailed info for a specific outcome ID
get_market_summaryRich overview with probabilities, settlement status, and parsed metadata
get_orderbookL2 order book (bids, asks, spread) for an outcome side
get_pricesCurrent mid-prices for all outcome coins
get_candlesOHLCV candle data for charting and analysis
get_recent_tradesLatest trades on a specific market
get_user_fillsTrade history for a wallet address
get_open_ordersResting limit orders for a wallet
get_user_positionsCurrent outcome share holdings and values

Quick Start

Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

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

Restart Claude Desktop, then try:

  • "What are the current HIP-4 prediction market odds?"
  • "Show me the orderbook for outcome 13"
  • "What positions does 0x1393...1869 hold?"

Claude Code

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

Run Standalone

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

Configuration

Env VariableDefaultDescription
HL_API_URLhttps://api.hyperliquid-testnet.xyzHyperliquid API endpoint

Set to https://api.hyperliquid.xyz for mainnet data.

Example Queries

Market Odds

"What are the odds on BTC above $71,566?"

Uses get_market_summary to fetch all markets, finds BTC markets, returns current probabilities.

Orderbook Analysis

"Is there good liquidity on the Hypurr vs Usain Bolt market?"

Uses get_orderbook to check bid/ask depth, spread, and order count.

Portfolio Check

"What are my positions and PnL?"

Uses get_user_positions + get_user_fills to show holdings and trade history.

Price History

"How has the HYPE prediction market moved in the last 24 hours?"

Uses get_candles with 1h interval to show price movement over time.

What is HIP-4?

HIP-4 (Hyperliquid Improvement Proposal 4) introduces prediction markets that run natively on Hyperliquid's L1 order book engine. Key features:

  • Binary outcomes (Yes/No) priced 0-100 cents
  • Fully collateralized (no leverage, no liquidation risk)
  • Shares the same infrastructure as perps and spot
  • Supports recurring markets (15M, 1H, 1D periods)
  • Settlement via on-chain oracle

Premium API (x402)

For enriched data with orderbook depth, volume, and metadata:

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

Paywalled at $0.001/request via x402 USDC micropayments on Base Sepolia.

Links

License

MIT

Ver o original no GitHub

Bom para

Relacionados