行情

訂閱行情數據推送.

警告

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

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

Topic:
tickers.{symbol}

響應參數

Linear/Inverse
Option
Spot

參數	類型	說明
topic	string	Topic名稱
type	string	數據類型. `snapshot`,`delta`
cs	integer	撮合版本號
ts	number	行情服務生成數據的時間戳 (毫秒)
data	array	Object
> symbol	string	合約名稱
> tickDirection	string	價格變化方向
> price24hPcnt	string	市場價格相對24h前變化的百分比
> lastPrice	string	最新市場成交價
> prevPrice24h	string	24小時前的整點市價
> highPrice24h	string	最近24小時的最高價
> lowPrice24h	string	最近24小時的最低價
> prevPrice1h	string	1小時前的整點市價
> markPrice	string	標記價格
> indexPrice	string	指數價格
> openInterest	string	未平倉合約的數量
> openInterestValue	string	未平倉合約的價值
> turnover24h	string	最近24小時成交額
> volume24h	string	最近24小時成交量
> nextFundingTime	string	下次結算資金費用的時間戳 (毫秒)
> fundingRate	string	資金費率
> bid1Price	string	買1價
> bid1Size	string	買1價的數量
> ask1Price	string	賣1價
> ask1Size	string	賣1價的數量
> deliveryTime	datetime	交割日期時間 (UTC+0). 反向交割和USDC交割獨有字段
> basisRate	string	基差率. 反向交割和USDC交割獨有字段
> deliveryFeeRate	string	交割費率. 反向交割和USDC交割獨有字段
> predictedDeliveryPrice	string	預估交割價格. 反向交割和USDC交割獨有字段

參數	類型	說明
topic	string	Topic名稱
id	string	消息id
type	string	數據類型. `snapshot`
ts	number	行情服務生成數據的時間戳 (毫秒)
data	array	Object
> symbol	string	合約名稱
> bidPrice	string	買1價
> bidSize	string	買1價的數量
> bidIv	string	買1價對應的iv
> askPrice	string	賣1價
> askSize	string	賣1價的數量
> askIv	string	賣1價對應的iv
> lastPrice	string	最新市場成交價
> highPrice24h	string	最近24小時的最高價
> lowPrice24h	string	最近24小時的最低價
> markPrice	string	標記價格
> indexPrice	string	指數價格
> markPriceIv	string	標記價格對應的iv
> underlyingPrice	string	底層資產的價格
> openInterest	string	未平倉合約的數量
> turnover24h	string	最近24小時成交額
> volume24h	string	最近24小時成交量
> totalVolume	string	總成交量
> totalTurnover	string	總成交額
> delta	string	Delta
> gamma	string	Gamma
> vega	string	Vega
> theta	string	Theta
> predictedDeliveryPrice	string	預估交割價. 交割前30分鐘有值
> change24h	string	過去24小時的變化

參數	類型	說明
topic	string	Topic名稱
type	string	數據類型. `snapshot`,`delta`
cs	integer	撮合版本號
ts	number	行情服務生成數據的時間戳 (毫秒)
data	array	Object
> symbol	string	合約名稱
> lastPrice	string	最新市場成交價
> highPrice24h	string	最近24小時的最高價
> lowPrice24h	string	最近24小時的最低價
> prevPrice24h	string	24小時前的整點市價
> volume24h	string	最近24小時成交量
> turnover24h	string	最近24小時成交額
> price24hPcnt	string	市場價格相對24h前變化的百分比
> usdIndexPrice	string	USD指數價格用於計算統一帳戶裡資產折算成USD價值的價格若幣種不屬於抵押品幣種, 則返回空字符串

訂閱示例

Linear
Option
Spot

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)

from pybit.unified_trading import WebSocket
from time import sleep
ws = WebSocket(
    testnet=True,
    channel_type="option",
)
def handle_message(message):
    print(message)
ws.ticker_stream(
    symbol="tickers.BTC-22JAN23-17500-C",
    callback=handle_message
)
while True:
    sleep(1)

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

響應示例

Linear
Option
Spot

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

{
    "id": "tickers.BTC-6JAN23-17500-C-2480334983-1672917511074",
    "topic": "tickers.BTC-6JAN23-17500-C",
    "ts": 1672917511074,
    "data": {
        "symbol": "BTC-6JAN23-17500-C",
        "bidPrice": "0",
        "bidSize": "0",
        "bidIv": "0",
        "askPrice": "10",
        "askSize": "5.1",
        "askIv": "0.514",
        "lastPrice": "10",
        "highPrice24h": "25",
        "lowPrice24h": "5",
        "markPrice": "7.86976724",
        "indexPrice": "16823.73",
        "markPriceIv": "0.4896",
        "underlyingPrice": "16815.1",
        "openInterest": "49.85",
        "turnover24h": "446802.8473",
        "volume24h": "26.55",
        "totalVolume": "86",
        "totalTurnover": "1437431",
        "delta": "0.047831",
        "gamma": "0.00021453",
        "vega": "0.81351067",
        "theta": "-19.9115368",
        "predictedDeliveryPrice": "0",
        "change24h": "-0.33333334"
    },
    "type": "snapshot"
}

{
    "topic": "tickers.BTCUSDT",
    "ts": 1673853746003,
    "type": "snapshot",
    "cs": 2588407389,
    "data": {
        "symbol": "BTCUSDT",
        "lastPrice": "21109.77",
        "highPrice24h": "21426.99",
        "lowPrice24h": "20575",
        "prevPrice24h": "20704.93",
        "volume24h": "6780.866843",
        "turnover24h": "141946527.22907118",
        "price24hPcnt": "0.0196",
        "usdIndexPrice": "21120.2400136"
    }
}

響應參數​

訂閱示例​

響應示例​

響應參數

訂閱示例

響應示例