来源行情 · WebSocket

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

取消订阅

订阅消息 (type: subscribe)

SENDsubscribe / sourceTickers

客户端 → 服务端

接收 sourceTicker 事件。sources 按交易所 ID 筛选，省略时包含所有来源。价格按 quote 输出，事件仍保留原始交易对与原始计价币。不使用周期筛选。

确认消息: 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[]	是	仅订阅本类数据时填写此值。 可选值: ["sourceTickers"]
sources	string[]	否	仅筛选来源行情，使用 binance、bitbank 等交易所 ID。省略时包含所有来源。

示例

{
  "type": "subscribe",
  "id": "btc-sources",
  "symbol": "BTC",
  "quote": "JPY",
  "channels": [
    "sourceTickers"
  ],
  "sources": [
    "binance",
    "bitbank"
  ]
}

推送消息 (e: sourceTicker)

RECEIVEsourceTicker

服务端 → 客户端

来源行情：s 是基础资产，quote 是标准化的价格币种；p 和 q 保留交易所原始交易对与计价币。c、b、a、o、h、l 使用 quote 指定的币种；v 为基础资产数量。上游报价、汇率或可用的近期分钟 K 线缺失时，bid/ask 或派生的 24 小时字段可能省略。T 为来源时间，E 为 Oracle 推送时间。

vc 为 true 表示交易所提供原生 24 小时成交量，或此前 1,440 分钟的来源 K 线完整；为 false 时，v 是已有 K 线的合计，可能低于实际成交量。分钟线计算的 v 还包含当前活动分钟，覆盖范围最多多出一个未结束的分钟。跨币种的实时价格使用推送时最新可用的汇率；T 仍表示上游报价时间。

消息字段

字段	类型	必填	说明
e	string	是	固定为 sourceTicker。 可选值: "sourceTicker"
E	integer	是	Oracle 推送时间，Unix 毫秒。
s	string	是	基础资产符号。
quote	string	是	输出价格币种：JPY 或 USD。 可选值: "JPY", "USD"
T	integer	是	上游报价时间，Unix 毫秒。
x	string	是	交易所 ID。
p	string	是	交易所原始交易对，例如 BTCUSDT。
q	string	是	交易所原始计价币，例如 USDT。
c	string	是	最新价，十进制字符串。
b	string	否	最优买价，单位为 quote。
a	string	否	最优卖价，单位为 quote。
o	string	否	24 小时开盘价，单位为 quote。
h	string	否	24 小时最高价，单位为 quote。
l	string	否	24 小时最低价，单位为 quote。
v	string	否	24 小时基础资产成交量，十进制字符串。
vc	boolean	否	成交量的覆盖范围是否完整。

示例

{
  "e": "sourceTicker",
  "E": 1788220801000,
  "T": 1788220800123,
  "s": "BTC",
  "quote": "JPY",
  "x": "binance",
  "p": "BTCUSDT",
  "q": "USDT",
  "c": "15018000",
  "b": "15017000",
  "a": "15019000",
  "v": "1234.5678",
  "vc": true
}