跳至主要内容

行情

訂閱行情數據推送.

警告
  • 注意，該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). 反向交割和USDC交割獨有字段
> basisRatestring基差率. 反向交割和USDC交割獨有字段
> deliveryFeeRatestring交割費率. 反向交割和USDC交割獨有字段
> predictedDeliveryPricestring預估交割價格. 反向交割和USDC交割獨有字段
> preOpenPricestring盤前合約預估開盤價格
  • 在進入連續競價後, 該值無意義
  • USDC交割合約, 反向交割合約不輸出該字段
    • > preQtystring盤前合約預估開盤數量
  • 進入連續競價後, 該值無意義
  • USDC交割合約, 反向交割合約不輸出該字段
    • > curPreListingPhasestring當前盤前交易階段
  • USDC交割合約, 反向交割合約不輸出該字段

    • 訂閱示例​

    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)

    響應示例​

    {
        "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
    }