Candles
OHLCV candles for crypto perpetual futures, 1m to 1d, on trade price (mark and index where the venue publishes them), across 20 venues (Aster Perpetuals, Avantis, Binance USD-M Futures, Bitget Perpetual Futures, Bitunix, Bybit Perpetuals, Coinbase Global Derivatives and 13 more). Built from venue 1-minute klines; periods with no data come back as gap rows, not interpolated. DQL filter, timeframe, from, to. No charge when no candle is returned. 0.005 USDC per call.
POST https://api.debyko.com/v2/candles
0.005 USDC on Base · payTo 0x17b2c55872338727660aa77776a4056a1a3158ec
Status: verified · payable
Operator badge: embed this endpoint's live status badge — it reads "Verified Payable" only while the probe record backs it.
Settlement: direct to the seller's payTo — 0% HIVE402 take
Payment routes
{
"from": "2026-10-01T00:00:00Z",
"timeframe": "1h",
"to": "2026-10-01T06:00:00Z",
"where": "base in (BTC)"
}{
"evaluated_at": "2026-10-14T12:00:05Z",
"from": "2026-10-01T00:00:00Z",
"items": [
{
"candles": [
{
"close": 64180.5,
"close_time": "2026-10-01T01:00:00Z",
"high": 64210,
"low": 64050,
"open": 64100,
"open_time": "2026-10-01T00:00:00Z",
"received_at": null,
"status": "present",
"trade_count": 9130,
"venue_ts": null,
"volume": 512.4
}
],
"instrument": "BTC-PERP",
"kind": "perpetual",
"quote": "USDC",
"retention_from": "2026-09-21T00:00:00Z",
"source": "derived",
"status": "present",
"units": {
"price": "quote",
"volume": "base"
},
"venue": "HYPERLIQUID",
"venue_symbol": "BTC"
}
],
"items_sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"price_type": "trade",
"receipt_id": "3yLdkPqXw7ZaB2nVt0RhUe",
"served_at": "2026-10-14T12:00:05.000000Z",
"settled": true,
"timeframe": "1h",
"to": "2026-10-01T06:00:00Z",
"units": "published"
}Script Master Labs LLC · SDVOSB · Kinston, NC · Terms · Refunds · Privacy · Contact
SML network: ScriptMasterLabs — the main site · SML Dual Market — the human storefront · VA Ratings — VA disability ratings, free for veterans
Agent intel 
| Trust score | 66 / 100 · breakdown |
|---|---|
| Probe uptime (30d) | 100.0% over 1 probes · daily |
| Avg 402 latency | 139 ms |
| Paid calls (30d, on-chain) | 1 calls · 1 buyers · shared price cohort of 2 |
| Facilitator-reported (30d) | 2 calls · 2 payers (CDP Bazaar) |
How to call
POST https://api.debyko.com/v2/candles · input in body · spec from live-challenge
Input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"timeframe",
"from",
"to"
],
"properties": {
"where": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "DQL selection of the markets to read, e.g. base in (BTC) or venue = HYPERLIQUID and base = BTC."
},
"kind": {
"type": "string",
"enum": [
"perpetual",
"spot",
"all"
],
"default": "perpetual"
},
"units": {
"type": "string",
"enum": [
"published",
"base"
],
"default": "published"
},
"number_format": {
"type": "string",
"enum": [
"json",
"string"
],
"default": "json"
},
"include_synthetic": {
"type": "boolean",
"default": false
},
"timeframe": {
"type": "string",
"description": "Candle period, e.g. 1m, 15m, 1h or 1d; GET /v2/dql/catalogue lists them."
},
"price_type": {
"type": "string",
"enum": [
"trade",
"mark",
"index"
],
"default": "trade",
"description": "trade (default), mark or index."
},
"from": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$",
"description": "Start of the window, UTC, e.g. 2026-10-01T00:00:00Z."
},
"to": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$",
"description": "End of the window, UTC, e.g. 2026-10-01T06:00:00Z."
},
"include_gaps": {
"type": "boolean",
"default": true,
"description": "true (default) keeps periods with no candle as gap rows."
},
"closed_only": {
"type": "boolean",
"default": true
},
"trade": {
"type": "boolean"
},
"as_of": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$"
}
}
}Output schema
{
"type": "object",
"additionalProperties": false,
"required": [
"evaluated_at",
"settled",
"items_sha256",
"timeframe",
"price_type",
"from",
"to",
"units",
"items"
],
"properties": {
"evaluated_at": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$"
},
"served_at": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{6}Z$"
},
"receipt_id": {
"type": "string",
"pattern": "^[0-9A-Za-z]{22}$"
},
"resolved_from": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"trial": {
"type": "object",
"additionalProperties": false,
"required": [
"plan",
"until"
],
"properties": {
"plan": {
"type": "string"
},
"until": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$"
},
"layer": {
"type": "string"
},
"asked_days": {
"type": "integer"
},
"cap": {
"type": "string"
},
"limit": {
"type": "integer"
}
}
},
"settled": {
"type": "boolean"
},
"items_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"timeframe": {
"type": "string"
},
"price_type": {
"type": "string",
"enum": [
"trade",
"mark",
"index"
]
},
"from": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$"
},
"to": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$"
},
"units": {
"type": "string",
"enum": [
"published",
"base"
]
},
"normalisation_version": {
"type": "string"
},
"listings_as_of": {
"oneOf": [
{
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$"
},
{
"type": "null"
}
]
},
"capabilities_as_of": {
"oneOf": [
{
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$"
},
{
"type": "null"
}
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"instrument",
"venue",
"venue_symbol",
"quote",
"status",
"source",
"retention_from",
"units",
"candles"
],
"properties": {
"instrument": {
"type": [
"string",
"null"
]
},
"reason": {
"type": "string",
"enum": [
"not_retained",
"gap",
"insufficient_history",
"reference_not_listed",
"policy_off",
"venue_capability",
"no_value",
"band_truncated",
"partial_coverage",
"unit_unknown",
"unmapped",
"funding_continuous",
"collector_gap",
"horizon_passed",
"connection_lost",
"state_lag",
"source_error",
"horizon_unknown",
"freshness_bound",
"halted",
"no_update",
"not_in_scope",
"no_venues"
]
},
"venue": {
"type": "string"
},
"venue_symbol": {
"type": "string"
},
"identity_basis": {
"type": "string",
"enum": [
"recorded",
"reconstructed"
]
},
"identity_corrected_at": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$"
},
"quote": {
"type": [
"string",
"null"
]
},
"kind": {
"type": "string",
"enum": [
"perpetual",
"spot"
]
},
"status": {
"type": "string",
"enum": [
"present",
"stale",
"missing",
"not_published",
"off"
]
},
"source": {
"type": "string",
"enum": [
"venue",
"derived"
]
},
"retention_from": {},
"units": {
"type": "object"
},
"reasons": {
"type": "object"
},
"candles": {
"type": "array"
}
}
}
},
"data_as_of": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{3})?Z$"
}
}
}curl -i -X POST 'https://api.debyko.com/v2/candles' \
-H 'content-type: application/json' -d '{"where":"base in (BTC)","timeframe":"1h","from":"2026-10-01T00:00:00Z","to":"2026-10-01T06:00:00Z"}'
Agents: POST https://hive402.scriptmasterlabs.com/mcp → route_task / proxy_call · SDK /sdk/hive402.mjs