查询加密货币 K 线

按币种代码查询公开 OHLCV K 线，了解请求参数、时间单位和响应字段。

GET /api/v4/event_contracts/crypto/candlesticks

查询加密货币 K 线

cURL

curl --request GET \
  --url https://api.dexbuilder.com/api/v4/event_contracts/crypto/candlesticks

200

{
  "symbol": "<string>",
  "interval": "<string>",
  "history": [
    {
      "t": 123,
      "o": "<string>",
      "h": "<string>",
      "l": "<string>",
      "c": "<string>",
      "v": "<string>"
    }
  ],
  "source": "<string>"
}

通过币种代码查询公开 OHLCV K 线。此接口无需认证。

Base URL：https://api.dexbuilder.com

​

请求参数

参数	必填	说明
symbol	二选一	币种代码，不区分大小写。当前支持 BTC、ETH、HYPE、XRP、SOL、DOGE、BNB；新接入建议使用此参数。
tag_id	二选一	兼容参数：正整数加密货币标签 ID，例如 BTC 为 235；不接受 ge_ 前缀。
interval	是	展示档位：1m、5m、15m、1h、4h、1d、1w、1mon、1y、all。
start_ts	否	起始 Unix 秒；省略或传 0 时按服务端默认规则处理。
end_ts	否	结束 Unix 秒；省略或传 0 时按服务端默认规则处理。

symbol 与 tag_id 必须且只能提供其中一个。tag_id 暂时保留兼容，建议已有调用迁移到 symbol。两个非零时间边界同时提供时，end_ts 必须大于 start_ts。

interval 选择展示档位，不保证每根返回 K 线的时间宽度；请使用 history[].t 判断采样时间。interval=all 不保证返回全部历史；查询指定范围时请传入 start_ts 和 end_ts。

curl "https://api.dexbuilder.com/api/v4/event_contracts/crypto/candlesticks?symbol=BTC&interval=1h"

​

响应

成功时返回包含币种交易对、展示档位及历史 K 线的对象：

{
  "symbol": "BTCUSD",
  "interval": "1h",
  "source": "binance",
  "history": [
    { "t": 1700000000, "o": "30000", "h": "30100", "l": "29900", "c": "30050", "v": "12.5" }
  ]
}

history[].t 为 Unix 秒；开、高、低、收和成交量均为十进制字符串。source 为数据源名称，未提供时该字段省略。某些数据源没有成交量，可返回 "0"；无数据时 history 为 []。

参数无效返回 HTTP 400，错误 label 为 INVALID_PARAM_VALUE；行情源不可用返回 HTTP 503，错误 label 为 QUOTE_UNAVAILABLE。

查询参数

symbol · string

币种代码，大小写不敏感。当前支持 BTC、ETH、HYPE、XRP、SOL、DOGE、BNB；与 tag_id 二选一。

示例:

"BTC"

tag_id · integer

兼容参数：正整数加密货币标签 ID；与 symbol 二选一。新接入建议使用 symbol。

必填范围: x >= 1

示例:

235

interval · enum<string> · 必填

展示档位。

可用选项: 1m, 5m, 15m, 1h, 4h, 1d, 1w, 1mon, 1y, all

start_ts · integer

起始 Unix 秒；省略或为 0 时按服务端默认规则处理。

必填范围: x >= 0

end_ts · integer

结束 Unix 秒；省略或为 0 时按服务端默认规则处理。

必填范围: x >= 0

响应

200

application/json

请求成功

加密货币 K 线响应。

symbol · string · 必填

币种交易对标识。

interval · string · 必填

history · object[] · 必填

OHLCV K 线，按时间返回。

Show child attributes

source · string

数据源名称；上游未提供时省略。