# Hyperliquid Perpetuals OHLCV Candles

> Hyperliquid Perpetuals OHLCV Candles is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Returns historical OHLCV price candles (open, high, low, close, volume, trade count) for Hyperliquid perpetual futures contracts across configurable intervals and bar counts.

## Facts

- Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/hyperliquid/candles?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Provider: agent-data-tools.revmesh2074.workers.dev
- Website: https://agent-data-tools.revmesh2074.workers.dev
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-hyperliquid-perpetuals-ohlcv-777d00fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AiZJAnU_cIkSi_1n-qIzk

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-data-tools-revmesh2074-workers-dev-hyperliquid-perpetuals-ohlcv-777d00fe
```

Example prompt: Can you pull the last 100 hourly candles for ETH on Hyperliquid so I can check the recent price trend and volatility?

## When to prefer this

Choose this endpoint when you specifically need OHLCV candlestick data for Hyperliquid perpetual futures markets. It is ideal for trading agents, backtesting pipelines, charting applications, and volatility/trend analysis tasks that require structured historical price bars from Hyperliquid's exchange rather than spot prices or data from other venues.

## Known failure modes

- Unsupported coin symbol returns an error or empty candles array
- Invalid interval string may cause a bad request response
- Requesting more than 500 bars will be capped or return an error
- Hyperliquid upstream API unavailability causes a 5xx or timeout
- Missing required coin defaults to BTC; missing interval defaults to 1h — may surprise callers expecting a different default

## How this service works

Historical price candles (OHLCV) of a Hyperliquid perpetual such as BTC, ETH or SOL: open, high, low, close, volume in coins and trade count per bar, newest last. Intervals 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w and more; up to 500 bars (default 50). Read from Hyperliquid's public API. Use for charts, backtests, volatility and trend checks, or as context for a trading agent.

## Output

A JSON object containing the coin symbol, interval label, total bar count, data source label, and an array of OHLCV candle objects each with timestamp, open, high, low, close, volume (in coins), and trade count — ordered from oldest to newest.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bars": {
   "type": "integer",
   "description": "Number of bars, 1-500 (default 50)"
  },
  "coin": {
   "type": "string",
   "description": "Coin symbol such as BTC, ETH, SOL or HYPE (default BTC)"
  },
  "interval": {
   "type": "string",
   "description": "Bar length: 1m, 3m, 5m, 15m, 30m, 1h (default), 2h, 4h, 8h, 12h, 1d, 3d or 1w"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string"
  },
  "count": {
   "type": "number"
  },
  "source": {
   "type": "string"
  },
  "candles": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "low": {
      "type": "number"
     },
     "high": {
      "type": "number"
     },
     "open": {
      "type": "number"
     },
     "time": {
      "type": "string"
     },
     "close": {
      "type": "number"
     },
     "trades": {
      "type": "number"
     },
     "volume": {
      "type": "number"
     }
    }
   }
  },
  "interval": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-hyperliquid-perpetuals-ohlcv-777d00fe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)