获取 K 线

路径参数

• idstring必填

  市场 ID，比如 binference-2026-10-24：在这一天 UTC 00:00 到期的 bInference 额度。开放中的市场见 GET /dex/markets。

查询参数

• interval"1m" | "5m" | "15m" | "1h" | "4h" | "1d"

  K 线周期：1m、5m、15m、1h、4h 或 1d。不填时为 1h。

• limitinteger

  覆盖最近多少个周期（包括当前周期），1 到 1,000。不填时为 200。

返回

• marketstring

  市场 ID。

• intervalstring

  请求的 K 线周期。

• candlesobject[]

  每个有成交的周期一根 K 线，最早的在前。没有成交的周期没有 K 线。

  • timeinteger

    周期的开始时间，以毫秒计。周期按 UTC 时间对齐：4h K 线从 00:00、04:00 等时刻开始。

  • openstring

    第一笔成交的价格。

  • highstring

    最高价。

  • lowstring

    最低价。

  • closestring

    最后一笔成交的价格。最新的 K 线仍可能变化。

  • volumestring

    成交的额度，以美元计。

  • quoteVolumestring

    支付的 USDT。

  • tradesinteger

    成交笔数。

错误

每个错误都以 JSON 返回：{ "error": { "code", "message" } }，其中 code 是稳定的错误码，可以据此判断。

• invalid_interval400

  interval 不是 1m、5m、15m、1h、4h 或 1d 之一。

• invalid_limit400

  limit 不是允许范围内的整数。

• unknown_parameter400

  这个端点不接受的查询参数，或者同一个参数发送了两次。只发送这里列出的参数，每个一次，并按所示写法书写：其他请求在计入权重之前就会被拒绝。

• not_found404

  DEX 尚未开放。

• unknown_market404

  没有这个 ID 的开放中市场。已收盘的市场也会返回这个错误。市场 ID 请从 GET /dex/markets 获取。

• rate_limited429

  这个 IP 地址一分钟内用掉了超过 1,200 权重。等待 Retry-After 中的秒数后再请求。