# Hyperliquid OHLCV Candles Data

> Hyperliquid OHLCV Candles Data is a paid API for AI agents from klymax402.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Fetches OHLCV candlestick data for a given cryptocurrency from Hyperliquid DEX, with configurable interval and limit.

## Facts

- Endpoint: GET https://klymax402.com/api/hyperliquid-data/api/candles
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-ohlcv-candles-data-f331fdbc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AWBy4F8MJuHzbyjl_OGCt

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 hyperliquid-ohlcv-candles-data-f331fdbc
```

Example prompt: Pull me 200 candles of BTC on Hyperliquid at the 1-hour interval so I can analyze the recent price action.

## When to prefer this

Choose this endpoint when you need OHLCV candlestick data specifically from Hyperliquid DEX — a leading perpetuals DEX — rather than centralized exchange data. Ideal for DeFi-native trading strategies, backtesting, or real-time chart analysis where Hyperliquid's perpetuals market data is relevant. Prefer this over generic crypto data APIs when Hyperliquid-specific price discovery is important.

## Known failure modes

- Unknown or unsupported coin symbol returns empty candles or error
- Invalid interval string returns a bad request error
- Limit exceeding 5000 may be capped or rejected
- Network or upstream Hyperliquid API downtime causes failure
- Missing required 'coin' query parameter returns validation error

## How this service works

One MCP endpoint gives your AI agent access to 100 APIs -- crypto, DeFi, web, AI, finance and utilities. No API keys, USDC on Base from $0.003/call.

## Output

Returns a JSON object containing the coin symbol, the requested interval, the count of candles returned, and an array of OHLCV candlestick objects (open, high, low, close, volume) for the specified cryptocurrency from Hyperliquid.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "coin"
     ],
     "properties": {
      "coin": {
       "type": "string",
       "description": "Coin symbol (e.g. BTC, ETH, SOL)"
      },
      "limit": {
       "type": "number",
       "description": "Number of candles to return (default 100, max 5000)"
      },
      "interval": {
       "type": "string",
       "description": "Candle interval (1m, 5m, 15m, 1h, 4h, 1d)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "example",
  "count": 1,
  "candles": [],
  "interval": "example"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-ohlcv-candles-data-f331fdbc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from klymax402.com](https://www.zero.xyz/host/klymax402.com/llms.txt)