Historical OHLCV candles for one Hyperliquid spot market at the requested interv
Historical OHLCV candles for one Hyperliquid spot market at the requested interval (1m, 5m, 15m, 1h, 4h, 1d, 1w) over a time window. Pass a token symbol (e.g. HYPE, PURR) or @index and tune with `?interval=` (default 1h), `?lookback=` candles (default 200, max 5000), or `?start=`/`?end=` epoch-ms. Spot candles — for perp candles use /api/v1/perps/candles/{coin}. From x402stock
Answeringour last check, 2026-09-24
1 of 1checks answered this week
461 msmedian answer time
$0.02listed price per call
$0.02price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
GET https://agents.x402stock.xyz/api/v1/spot/candles/:token
| Category | Market data |
|---|---|
| Provider host | agents.x402stock.xyz |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 2 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.02 | 461 ms |
Example input (from the provider)
{
"method": "GET",
"pathParams": {
"token": "PURR"
},
"queryParams": {},
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"pathParams": {
"token": {
"type": "string"
},
"type": "object"
},
"queryParams": {
"properties": {
"end": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"interval": {
"default": "1h",
"enum": [
"1m",
"3m",
"5m",
"15m",
"30m",
"1h",
"2h",
"4h",
"8h",
"12h",
"1d",
"3d",
"1w",
"1M"
],
"type": "string"
},
"lookback": {
"default": 200,
"exclusiveMinimum": 0,
"maximum": 5000,
"type": "integer"
},
"start": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}