跳至主要内容

行情

訂閱行情數據推送.

警告
  • 注意,該topic推送delta數據和snapshot数据。如果delta數據中缺失一些字段,表明該字段自上次推送以來沒有發生變化。
  • 現貨只推送snapshot類型數據

推送頻率: 期貨 - 100ms, 現貨 - 實時

Topic:
tickers.{symbol}

響應參數

參數類型說明
topicstringTopic名稱
typestring數據類型. `snapshot`,`delta`
csinteger撮合版本號
tsnumber行情服務生成數據的時間戳 (毫秒)
dataarrayObject
> symbolstring合約名稱
> tickDirectionstring價格變化方向
> price24hPcntstring市場價格相對24h前變化的百分比
> lastPricestring最新市場成交價
> prevPrice24hstring24小時前的整點市價
> highPrice24hstring最近24小時的最高價
> lowPrice24hstring最近24小時的最低價
> prevPrice1hstring1小時前的整點市價
> markPricestring標記價格
> indexPricestring指數價格
> openIntereststring未平倉合約的數量
> openInterestValuestring未平倉合約的價值
> turnover24hstring最近24小時成交額
> volume24hstring最近24小時成交量
> nextFundingTimestring下次結算資金費用的時間戳 (毫秒)
> fundingRatestring資金費率
> bid1Pricestring買1價
> bid1Sizestring買1價的數量
> ask1Pricestring賣1價
> ask1Sizestring賣1價的數量

訂閱示例

const socket = new WebSocket('wss://stream-testnet.zoomex.com/v3/public/linear');

socket.onopen = function() {
const subscribeMsg = {
"op": "subscribe",
"args": ["tickers.BTCUSDT"]
};
socket.send(JSON.stringify(subscribeMsg));
};

socket.onmessage = function(event) {
};

socket.onclose = function(event) {
};

響應示例

{
"topic": "tickers.BTCUSDT",
"type": "snapshot",
"data": {
"symbol": "BTCUSDT",
"tickDirection": "PlusTick",
"price24hPcnt": "0.017103",
"lastPrice": "17216.00",
"prevPrice24h": "16926.50",
"highPrice24h": "17281.50",
"lowPrice24h": "16915.00",
"prevPrice1h": "17238.00",
"markPrice": "17217.33",
"indexPrice": "17227.36",
"openInterest": "68744.761",
"openInterestValue": "1183601235.91",
"turnover24h": "1570383121.943499",
"volume24h": "91705.276",
"nextFundingTime": "1673280000000",
"fundingRate": "-0.000212",
"bid1Price": "17215.50",
"bid1Size": "84.489",
"ask1Price": "17216.00",
"ask1Size": "83.020"
},
"cs": 24987956059,
"ts": 1673272861686
}