{
  "id": "surf.hyperliquid.candles",
  "object": "tool",
  "name": "Market Candles",
  "summary": "Returns market OHLCV candles for charting and trade-review overlays, ordered by open_time ascending.",
  "description": "Returns market OHLCV candles for charting and trade-review overlays, ordered by open_time ascending. Each row also carries trades, closed, and nullable quote volume (null before quote-volume coverage). symbol, from, and to are required; from/to accept Unix seconds, ISO datetimes, or UTC dates, and candle open_time is bounded to the half-open [from,to) window. The requested window may contain at most 5000 candles, so use a larger interval for long histories. The response is market data and does not require a wallet address.\n\nRaw surf#hyperliquid/candles endpoint: input is { body, queryParams, pathParams } as the provider documents them (https://docs.asksurf.ai).",
  "category": "lookup",
  "hosted_by": "Surf",
  "runtime": "partner",
  "side_effects": false,
  "status": "live",
  "credits": 0,
  "price": null,
  "providers": [
    {
      "id": "surf",
      "name": "Surf",
      "price": null,
      "own_key_only": true
    }
  ],
  "mcp_name": "surf_hyperliquid_candles",
  "input_schema": {
    "type": "object",
    "properties": {
      "queryParams": {
        "type": "object",
        "properties": {
          "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": {
            "default": "4h",
            "type": "string",
            "enum": [
              "1m",
              "3m",
              "5m",
              "15m",
              "30m",
              "1h",
              "2h",
              "4h",
              "8h",
              "12h",
              "1d",
              "3d",
              "1w",
              "1M"
            ],
            "description": "Candle granularity. Example: 4h. Defaults to \"4h\"."
          },
          "from": {
            "type": "string",
            "minLength": 1,
            "description": "Window start (Unix seconds, an ISO datetime, or a bare UTC date). Example: 2026-05-16."
          },
          "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."
          }
        },
        "required": [
          "symbol",
          "from",
          "to"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "queryParams"
    ],
    "additionalProperties": false
  },
  "kind": "endpoint"
}