# Vextorium Hyperliquid Perpetual OHLCV Candles

> Vextorium Hyperliquid Perpetual OHLCV Candles is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-29).

Returns OHLCV candlestick data for a Hyperliquid perpetual futures asset across multiple timeframes, with summary statistics including period change, high/low, and annualized volatility.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/hyperliquid-candles?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-hyperliquid-perpetual-ohlcv-candles-c8631381
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ze8WL_hAm4bJVcItIC6cQ

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 vextorium-hyperliquid-perpetual-ohlcv-candles-c8631381 -d '<json body>'
```

Example prompt: Pull the last 50 daily OHLCV candles for BTC from Hyperliquid perps and tell me the annualized volatility and the period's high and low.

## When to prefer this

Choose this endpoint when you need Hyperliquid-native perpetual futures OHLCV data with built-in summary analytics (volatility, period change, high/low) rather than raw exchange data. It is especially useful for agents doing technical analysis or volatility assessments on Hyperliquid perps specifically, as prices come directly from Hyperliquid's own open market rather than aggregators.

## Known failure modes

- Unsupported or misspelled currency symbol returns an error or empty candle array
- Limit value outside 2-500 range may be rejected or clamped
- Hyperliquid API downtime causes upstream data unavailability
- Requesting a very fine interval (1m) with a high limit may return sparse data for illiquid assets
- Missing required 'currency' field returns a validation error

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

A JSON object containing the asset symbol, data source (Hyperliquid perp market), an array of OHLCV candle objects (each with start timestamp, open, close, high/max, low/min, volume, and trade count), the requested interval, and a summary object with overall period high, low, percentage change, and annualized volatility percentage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Candles (2-500, default 30)"
  },
  "currency": {
   "type": "string"
  },
  "interval": {
   "enum": [
    "1m",
    "5m",
    "15m",
    "1h",
    "4h",
    "1d",
    "1w"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asset": "SOL",
  "source": "Hyperliquid (price from its own perp market; open data)",
  "candles": [
   {
    "max": 122.44,
    "min": 119.79,
    "open": 122.16,
    "close": 121.38,
    "start": "2026-09-26T00:00+00:00",
    "trades": 71415,
    "volume": 1833469.96
   },
   {
    "max": 124.95,
    "min": 120.12,
    "open": 121.38,
    "close": 121.95,
    "start": "2026-09-27T00:00+00:00",
    "trades": 82822,
    "volume": 1837862.37
   }
  ],
  "summary": {
   "max": 124.95,
   "min": 116.3,
   "change_pct": -0.88,
   "annualized_volatility_pct": 27.97
  },
  "interval": "1d"
 }
}
```

## More

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