跳至主要内容

行情

訂閱行情數據推送.

警告
  • 注意，該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價的數量
> 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
    }