K线频道#

获取K线数据，推送频率最快是间隔1秒推送一次数据。

URL路径
请联系我们 dexapi@okx.com。

请求参数#

Parameter	Type	Required	Description
op	String	是	操作，`subscribe` `unsubscribe`
args	Array	是	请求订阅的频道列表
channel	String	是	频道名。 `dex-token-candle1s` `dex-token-candle1m` `dex-token-candle3m` `dex-token-candle5m` `dex-token-candle15m` `dex-token-candle30m` `dex-token-candle1H` `dex-token-candle2H` `dex-token-candle4H` `dex-token-candle6H` `dex-token-candle12H` `dex-token-candle1M` `dex-token-candle3M` `dex-token-candle1W` `dex-token-candle1D` `dex-token-candle2D` `dex-token-candle3D` `dex-token-candle5D` `dex-token-candle6Hutc` `dex-token-candle12Hutc` `dex-token-candle1Dutc` `dex-token-candle2Dutc` `dex-token-candle3Dutc` `dex-token-candle5Dutc` `dex-token-candle1Wutc` `dex-token-candle1Mutc` `dex-token-candle3Mutc`
chainIndex	String	是	链的唯一标识。 (如1代表Ethereum。更多可查看这里。)
tokenContractAddress	String	是	币种合约地址，EVM 链请传全小写地址

响应参数#

Parameter	Type	Description
event	String	事件, `subscribe` `unsubscribe` `error`
arg	Object	订阅的频道
channel	String	频道名
chainIndex	String	链的唯一标识。
tokenContractAddress	String	币种合约地址
code	String	错误码
msg	String	错误消息
｜connId	String	WebSocket连接ID

推送数据参数#

Parameter	Type	Description
arg	Object	订阅成功的频道
> channel	String	频道名
> chainIndex	String	链的唯一标识。
> tokenContractAddress	String	币种合约地址
data	Array	频道的数据
> ts	String	开始时间，Unix时间戳的毫秒数格式，如 1597026383085
> o	String	开盘价格
> h	String	最高价格
> l	String	最低价格
> c	String	收盘价格
> vol	String	交易量，以目标币种为单位
> volUsd	String	交易量，以美元为单位
> confirm	String	K线状态。 `0`：K线未完结 `1`：K线已完结

流通频道

交易频道

请求示例#

shell

{
  "op": "subscribe",
  "args": [
    {
      "channel": "dex-token-candle1s",
      "chainIndex": "1",
      "tokenContractAddress":"0x382bb369d343125bfb2117af9c149795c6c65c50"
    }
  ]
}

响应示例#

200

成功响应示例

{
  "event": "subscribe",
  "arg": {
    "channel": "dex-token-candle1s",
    "chainIndex": "1"
    "tokenContractAddress":"0x382bb369d343125bfb2117af9c149795c6c65c50"
  },
  "connId": "a4d3ae55"
}

失败响应示例

{
  "event": "error",
  "code": "60012",
  "msg": "Invalid request: {\"op\": \"subscribe\", \"argss\":[{ \"channel\" : \"dex-token-candle1s\", \"chainIndex\" : \"1\", \"tokenContractAddress\" : \"0x382bb369d343125bfb2117af9c149795c6c65c50\"}]}",
  "connId": "a4d3ae55"
}

推送数据示例

{
  "arg": {
    "channel": "dex-token-candle1s",
    "chainIndex": "1"
    "tokenContractAddress":"0x382bb369d343125bfb2117af9c149795c6c65c50"
  },
  "data": [
    [
      "1597026383085",
      "8533.02",
      "8553.74",
      "8527.17",
      "8548.26",
      "529.5858061",
      "226348.0482",
      "0"
    ]
  ]
}

流通频道

交易频道