跳至主要内容

行情

訂閱行情數據推送.

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

推送頻率: 期貨和期權 - 100ms, 現貨 - 50ms

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價的數量
> deliveryTimedatetime交割日期時間 (UTC+0), 僅適用於交割合約
> basisRatestring基差率. 反向交割和USDT/USDC交割獨有字段
> deliveryFeeRatestring交割費率. 反向交割和USDT/USDC交割獨有字段
> predictedDeliveryPricestring預估交割價格. 反向交割和USDT/USDC交割獨有字段
> preOpenPricestring盤前合約預估開盤價格
  • 在進入連續競價後, 該值無意義
  • USDT/USDC交割合約, 反向交割合約不輸出該字段
> preQtystring盤前合約預估開盤數量
  • 進入連續競價後, 該值無意義
  • USDT/USDC交割合約, 反向交割合約不輸出該字段
> curPreListingPhasestring當前盤前交易階段
  • USDT/USDC交割合約, 反向交割合約不輸出該字段
> fundingIntervalHourstring資金費率間隔（小時）
  • 此數值目前僅支援整數小時
  • 僅適用於永續合約；若為交割合約，不輸出該字段
> fundingCapstring資金費率上下限
  • 僅適用於永續合約；若為交割合約，不輸出該字段
> basisRateYearstring年化基準利率
  • 僅適用於交割合約；若為永續合約，不輸出該字段

訂閱示例​

from pybit.unified_trading import WebSocket
from time import sleep
ws = WebSocket(
    testnet=True,
    channel_type="linear",
)
def handle_message(message):
    print(message)
ws.ticker_stream(
    symbol="BTCUSDT",
    callback=handle_message
)
while True:
    sleep(1)

響應示例​

LinearPerpetual
{
  "topic": "tickers.BTCUSDT",
  "type": "snapshot",
  "data": {
    "symbol": "BTCUSDT",
    "tickDirection": "MinusTick",
    "price24hPcnt": "-0.158315",
    "lastPrice": "66666.60",
    "prevPrice24h": "79206.20",
    "highPrice24h": "79266.30",
    "lowPrice24h": "65076.90",
    "prevPrice1h": "66666.60",
    "markPrice": "66666.60",
    "indexPrice": "115418.19",
    "openInterest": "492373.72",
    "openInterestValue": "32824881841.75",
    "turnover24h": "4936790807.6521",
    "volume24h": "73191.3870",
    "fundingIntervalHour": "8",
    "fundingCap": "0.005",
    "nextFundingTime": "1760342400000",
    "fundingRate": "-0.005",
    "bid1Price": "66666.60",
    "bid1Size": "23789.165",
    "ask1Price": "66666.70",
    "ask1Size": "23775.469",
    "preOpenPrice": "",
    "preQty": "",
    "curPreListingPhase": ""
  },
  "cs": 9532239429,
  "ts": 1760325052630
}
LinearFutures
{
  "topic": "tickers.BTC-26DEC25",
  "type": "snapshot",
  "data": {
    "symbol": "BTC-26DEC25",
    "tickDirection": "ZeroMinusTick",
    "price24hPcnt": "0",
    "lastPrice": "109401.50",
    "prevPrice24h": "109401.50",
    "highPrice24h": "109401.50",
    "lowPrice24h": "109401.50",
    "prevPrice1h": "109401.50",
    "markPrice": "121144.63",
    "indexPrice": "114132.51",
    "openInterest": "6.622",
    "openInterestValue": "802219.74",
    "turnover24h": "0.0000",
    "volume24h": "0.0000",
    "deliveryTime": "2025-12-26T08:00:00Z",
    "basisRate": "0.06129209",
    "deliveryFeeRate": "0",
    "predictedDeliveryPrice": "0.00",
    "basis": "-4730.84",
    "basisRateYear": "0.30655351",
    "nextFundingTime": "",
    "fundingRate": "",
    "bid1Price": "111254.50",
    "bid1Size": "0.176",
    "ask1Price": "131001.00",
    "ask1Size": "0.580"
  },
  "cs": 31337927919,
  "ts": 1760409119857
}