Api Endpoint

DEBYKO

OHLCV candles for crypto perpetual futures, 1m to 1d, on trade price (mark and index where the venue publishes them), across 19 venues (Aster Perpetuals, Avantis, Binance USD-M Futures, Bitget Perpetual Futures, Bybit Perpetuals, Coinbase Global Derivatives, Coinbase — legacy API, migrated and 12 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.

Open interactive test console

Offering

Provider
api.debyko.com
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Blockchain And Crypto
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.debyko.com/v2/candles
MIME type
application/json
First seen
2026-10-16T01:50:24.663Z
Last seen
Tags
OHLCV, Candles, perpetuals, Derivatives, Crypto

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.005 USDC
Atomic price: 5000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
9 USDC
Atomic price: 9000000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 3
29 USDC
Atomic price: 29000000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 4
99 USDC
Atomic price: 99000000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 5
249 USDC
Atomic price: 249000000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5000",
    "payTo": "0x17b2c55872338727660aa77776a4056a1a3158ec"
  },
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "9000000",
    "payTo": "0x17b2c55872338727660aa77776a4056a1a3158ec"
  },
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "29000000",
    "payTo": "0x17b2c55872338727660aa77776a4056a1a3158ec"
  },
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "99000000",
    "payTo": "0x17b2c55872338727660aa77776a4056a1a3158ec"
  },
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "249000000",
    "payTo": "0x17b2c55872338727660aa77776a4056a1a3158ec"
  }
]

Observed health

Status
Reachable
Latest latency
499 ms
Average latency
611 ms
HTTP status
405
Last checked
Reachability
100% over 15 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ]
    },
    "bodyType": {
      "type": "string",
      "enum": [
        "json",
        "form-data",
        "text"
      ]
    },
    "body": {
      "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$"
        }
      }
    },
    "queryParams": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "headers": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "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$"
        }
      }
    }
  },
  "required": [
    "type"
  ]
}