聚合行情 · WebSocket

连接、鉴权及订阅限制见 WebSocket 概览。

取消订阅

订阅消息 (type: subscribe)

SENDsubscribe / tickers

客户端 → 服务端

接收指定资产和计价币的 ticker 事件，不使用周期或来源筛选。两个资产字段都省略时订阅该计价币下全部资产，会占满 symbol 配额。

确认消息: subscribed

消息字段

字段	类型	必填	说明
type	string	是	固定为 subscribe。 可选值: "subscribe"
id	string	否	订阅 ID，默认 default。相同 ID 替换原订阅。 默认值: "default"
symbol	string	否	基础资产，例如 BTC，不附加计价币。
symbols	string[]	否	基础资产列表，同时提供 symbol 时合并处理。
quote	string	否	JPY（默认）或 USD。 可选值: "JPY", "USD" 默认值: "JPY"
channels	string[]	是	仅订阅本类数据时填写此值。 可选值: ["tickers"]

示例

{
  "type": "subscribe",
  "id": "btc-tickers",
  "symbol": "BTC",
  "quote": "JPY",
  "channels": [
    "tickers"
  ]
}

{
  "type": "subscribe",
  "id": "all-usd",
  "quote": "USD",
  "channels": [
    "tickers"
  ]
}

推送消息 (e: ticker)

RECEIVEticker

服务端 → 客户端

聚合行情：c 为最新价，v 为基础资产的滚动 24 小时成交量。可选的 p、P、P1h、P7d、P30d 表示价格变化。缺少完整 24 小时分钟历史时省略 v。分钟线计算的成交量会在此前 1,440 根已收盘分钟线之外加上当前活动分钟线，因此相对于逐笔成交的精确 24 小时窗口，最多多包含一个未结束的分钟。

消息字段

字段	类型	必填	说明
e	string	是	固定为 ticker。 可选值: "ticker"
E	integer	是	Oracle 推送时间，Unix 毫秒。
s	string	是	基础资产符号。
quote	string	是	输出价格币种：JPY 或 USD。 可选值: "JPY", "USD"
c	string	是	最新价，十进制字符串。
v	string	否	24 小时基础资产成交量，十进制字符串。
p	string	否	24 小时价格变化值，单位为 quote。
P	string	否	24 小时价格变化百分比，2.5 表示 2.5%。
P1h	string	否	1 小时价格变化百分比。
P7d	string	否	7 天价格变化百分比。
P30d	string	否	30 天价格变化百分比。

示例

{
  "e": "ticker",
  "E": 1787974923000,
  "s": "BTC",
  "quote": "JPY",
  "c": "15005000",
  "v": "123.45",
  "P": "2.5"
}