Hyperliquid OHLCV Candles (by Symbol & Interval)

{
  "type": "object",
  "required": [
    "symbol",
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "minLength": 1,
      "description": "Window end (Unix seconds, an ISO datetime, or a bare UTC date; a bare date means the end of that day). Example: 2026-05-19."
    },
    "from": {
      "type": "string",
      "minLength": 1,
      "description": "Window start (Unix seconds, an ISO datetime, or a bare UTC date). Example: 2026-05-16."
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Hyperliquid market id (for example BTC, kPEPE, xyz:GOLD, the canonical PURR/USDC spot pair, or an @index spot market). Example: SOL."
    },
    "interval": {
      "enum": [
        "1m",
        "3m",
        "5m",
        "15m",
        "30m",
        "1h",
        "2h",
        "4h",
        "8h",
        "12h",
        "1d",
        "3d",
        "1w",
        "1M"
      ],
      "type": "string",
      "default": "4h",
      "description": "Candle granularity. Example: 4h. Defaults to \"4h\"."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "low": {
            "type": "number"
          },
          "high": {
            "type": "number"
          },
          "open": {
            "type": "number"
          },
          "close": {
            "type": "number"
          },
          "quote": {
            "type": "number",
            "description": "Quote-asset (dollar) volume traded during this candle."
          },
          "closed": {
            "type": "boolean",
            "description": "Whether this candle has finished forming. Observed true on every candle in both real fixtures (neither window's `to` reached the current time); an in-progress candle for the current interval was never observed, so a false value is expected but unconfirmed."
          },
          "symbol": {
            "type": "string",
            "description": "Echoes the requested market id."
          },
          "trades": {
            "type": "integer",
            "description": "Number of trades that occurred during this candle."
          },
          "volume": {
            "type": "number",
            "description": "Base-asset volume traded during this candle."
          },
          "interval": {
            "type": "string",
            "description": "Echoes the requested candle granularity."
          },
          "open_time": {
            "type": "integer",
            "description": "Unix seconds marking the start of this candle."
          },
          "close_time": {
            "type": "integer",
            "description": "Unix seconds marking the end of this candle."
          }
        },
        "additionalProperties": false
      },
      "description": "One entry per candle interval in the requested window, open_time ascending."
    },
    "meta": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "integer",
          "description": "Matched `total` on both real fixtures observed."
        },
        "total": {
          "type": "integer",
          "description": "Number of candles returned, e.g. 72 or 15."
        },
        "cached": {
          "type": "boolean",
          "description": "Whether this response was served from the provider's cache. Observed false on both real fixtures."
        },
        "offset": {
          "type": "integer",
          "description": "0 on both real fixtures observed."
        }
      },
      "additionalProperties": false
    }
  },
  "description": "The candle response, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": false
}