`hyperliquid_candles`

Pack: hyperliquid · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/hyperliquid_candles for the schema, then POST the same URL with its arguments for the data.

OHLCV price candles for one Hyperliquid market, from Hyperliquid’s own API.

Tool description as the model sees it

OHLCV candles for one Hyperliquid perp or spot symbol, from Hyperliquid’s public info API ({“type”:“candleSnapshot”}). Each candle: open/high/low/close/volume (base units), trade count, and the interval’s start/end timestamps. Pass lookback_hours for a window ending now (default 24h), or an explicit start_time/end_time (ISO date/datetime or unix seconds/milliseconds) for a specific historical window — Hyperliquid retains candle history well beyond 24h. interval accepts Hyperliquid’s own granularities: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, 1M.

Parameters

Name	Type	Required	Description
`coin`	string	yes	Perp symbol (e.g. “BTC”) or spot pair id/name (e.g. “@0” or “PURR/USDC”).
`interval`	string	no	1m \| 3m \| 5m \| 15m \| 30m \| 1h \| 2h \| 4h \| 8h \| 12h \| 1d \| 3d \| 1w \| 1M (default “1h”)
`lookback_hours`	number	no	Window length ending now, in hours (default 24). Ignored when start_time is given.
`start_time`	string	no	Window START — ISO date/datetime or unix seconds/milliseconds. Use with end_time for a window that does not end now.
`end_time`	string	no	Window END — same formats as start_time. Defaults to now.

Example call

Arguments

{
  "coin": "BTC",
  "interval": "1h",
  "lookback_hours": 6
}

curl

curl -X POST https://gateway.pipeworx.io/hyperliquid/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hyperliquid_candles","arguments":{"coin":"BTC","interval":"1h","lookback_hours":6}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('hyperliquid_candles', {
  "coin": "BTC",
  "interval": "1h",
  "lookback_hours": 6
});

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the hyperliquid pack

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

See Getting Started for client-specific install steps.

hyperliquid_candles