{"slug":"api-debyko-com-v2-candles-52b4b0","title":"Completed OHLCV candles for crypto perpetuals, per venue, 1m to 1d, from stored ","host":"api.debyko.com","method":"POST","resource":"https://api.debyko.com/v2/candles","category":"market","description":"Completed OHLCV candles for crypto perpetuals, per venue, 1m to 1d, from stored trades.","price_listed":0.005,"price_asked":0.005,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":334,"reported_calls_30d":0,"reported_payers_30d":0,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"from":"2026-10-01T00:00:00Z","timeframe":"1h","to":"2026-10-01T06:00:00Z","where":"base in (BTC)"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"closed_only":{"default":true,"type":"boolean"},"from":{"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":"string"},"include_gaps":{"default":true,"type":"boolean"},"include_synthetic":{"default":false,"type":"boolean"},"number_format":{"default":"json","enum":["json","string"],"type":"string"},"price_type":{"default":"trade","enum":["trade","mark","index"],"type":"string"},"timeframe":{"type":"string"},"to":{"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":"string"},"trade":{"type":"boolean"},"units":{"default":"published","enum":["published","base","quote"],"type":"string"},"where":{"oneOf":[{"type":"string"},{"type":"object"}]}},"required":["timeframe","from","to"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"headers":{"additionalProperties":{"type":"string"},"type":"object"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"queryParams":{"additionalProperties":{"type":"string"},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"capabilities_as_of":{"oneOf":[{"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":"string"},{"type":"null"}]},"evaluated_at":{"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":"string"},"from":{"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":"string"},"items":{"items":{"additionalProperties":false,"properties":{"candles":{"type":"array"},"instrument":{"type":["string","null"]},"quote":{"type":["string","null"]},"reason":{"enum":["not_retained","gap","insufficient_history","policy_off","venue_capability","no_value","band_truncated","unit_unknown","unmapped","funding_continuous","collector_gap","horizon_passed","connection_lost","state_lag","horizon_unknown","freshness_bound"],"type":"string"},"reasons":{"type":"object"},"retention_from":{},"source":{"enum":["venue","derived"],"type":"string"},"status":{"enum":["present","stale","missing","not_published","off"],"type":"string"},"units":{"type":"object"},"venue":{"type":"string"},"venue_symbol":{"type":"string"}},"required":["instrument","venue","venue_symbol","quote","status","source","retention_from","units","candles"],"type":"object"},"type":"array"},"items_sha256":{"pattern":"^[0-9a-f]{64}$","type":"string"},"listings_as_of":{"oneOf":[{"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":"string"},{"type":"null"}]},"price_type":{"enum":["trade","mark","index"],"type":"string"},"receipt_id":{"pattern":"^[0-9A-Za-z]{22}$","type":"string"},"served_at":{"pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{6}Z$","type":"string"},"settled":{"type":"boolean"},"timeframe":{"type":"string"},"to":{"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":"string"},"units":{"enum":["published","base","quote"],"type":"string"}},"required":["evaluated_at","settled","items_sha256","timeframe","price_type","from","to","units","items"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-02","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.005,"price_match":true,"latency_ms":334,"error":null}],"description_full":"Completed OHLCV candles for crypto perpetuals, per venue, 1m to 1d, from stored trades.","last_updated":"2026-10-02T13:39:39.948Z","schemes":["exact"]}