Hyperliquid

What Hyperliquid does

Hyperliquid provides read-only access to public data from Hyperliquid's onchain perpetuals exchange and spot market. Its tools cover the listed perpetual and spot instruments, current prices, live order books, OHLCV candles, funding rates, and current open interest. Wallet-oriented tools return public account information for a supplied address, including perpetual margin and positions, spot balances, and account value history.

The integration is independent and unofficial. It does not place orders, sign requests, or expose Hyperliquid's authenticated exchange endpoints. No Hyperliquid API key, account credential, or signature is needed for the supported reads.

How it works

Requests are proxied per call to Hyperliquid's public POST api.hyperliquid.xyz/info endpoint. The hosted MCP connection is available at https://gateway.pipeworx.io/hyperliquid/mcp; a full Pipeworx gateway endpoint is also available when broader catalog access is useful. The pack endpoint includes shared Pipeworx meta-tools in addition to the Hyperliquid tools, although the local npm bridge lists only the pack tools unless configured otherwise.

The coin argument uses separate namespaces. Perpetuals use symbols such as BTC or ETH; spot pairs generally use identifiers such as @0, while some canonical pairs also have human-readable names. Use spot metadata to find the correct index rather than inferring it. Mixed price results can contain both perpetual symbols and spot identifiers.

Current open interest is reported in base-asset units, not USD. Candle queries can legitimately return an empty array when the requested time range contains no boundary for the selected interval. Account addresses are public pseudonymous identifiers; an unknown address produces an explicit no-activity result.

Setup and configuration

Add the hosted endpoint to an MCP client:

{
  "mcpServers": {
    "hyperliquid": {
      "url": "https://gateway.pipeworx.io/hyperliquid/mcp"
    }
  }
}

For local stdio usage, run the bridge with npx:

{
  "mcpServers": {
    "hyperliquid": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-hyperliquid"]
    }
  }
}

The bridge requires network access. Anonymous use is capped at 50 calls per day; setting PIPEWORX_API_KEY with a Pipeworx key raises the allowance to 200 calls per day. Set PIPEWORX_META_TOOLS=1 to include gateway-wide tools such as ask_pipeworx. For HTTPS proxy support with Node's fetch, newer Node versions may require NODE_USE_ENV_PROXY=1.

Tools and capabilities

• Inspect perpetual metadata, including size decimals, leverage, and delisting state.
• List spot pairs and their component token identifiers.
• Retrieve mid prices across all instruments or for one symbol.
• Read live funding, prices, volume, premium, and open interest for a perpetual.
• Query level-2 bid and ask books with optional depth.
• Retrieve candles and funding history over selected periods.
• Inspect a wallet's perpetual account, positions, spot balances, and account history.

Limitations and notes

Only public, read-only information is supported. Historical open-interest data is unavailable; the account tools do not identify the person behind an address. Hyperliquid's public endpoint applies IP-based weight limits, and rate-limit responses are returned from the upstream service rather than transformed into a Pipeworx-specific message.