跳至主要内容

獲取實时的詢價單資訊

獲取實时的詢價單資訊。每秒最多 50 次請求

信息
  • 獲取使用者發送或接收的詢價資訊,從 rfq-engine 即時查詢,無延遲
  • 同時傳遞 rfqId 和 rfqLinkId 時,以 rfqId 為準
  • 根據詢價單的創建時間倒序排列並返回。
  • HTTP 請求

    GET /v5/rfq/rfq-realtime

    請求參數

    參數是否必需類型說明
    rfqIdfalsestring詢價單 ID
    rfqLinkIdfalsestring詢價單自定義 ID,當 traderType 為 quote 時,此字段無效
    traderTypefalsestring交易者類型,quoterequest,默認為 request
  • Request:詢價方,查詢自己發出的詢價單
  • Quote:報價方,查詢自己接收到的詢價單
  • 響應參數

    參數類型說明
    listArray詢價單數據陣列
    > rfqIdstring詢價單 ID
    > rfqLinkIdstring自定義詢價單 ID,客戶敏感資訊不會公開,僅返回給報價方。
    > counterpartiesArray of strings報價方列表
    > expiresAtstring詢價單的過期時間,Unix 時間戳的毫秒格式
    > strategyTypestring詢價標籤
    > statusstring詢價單狀態:ActivePendingFillCanceledFilledExpiredFailed
    > deskCodestring詢價方的唯一識別代碼,若詢價時設置匿名為 true 則不可見
    > createdAtstring交易創建的時間(毫秒),例如 1650380963
    > updatedAtstring交易更新的時間(毫秒),例如 1650380964
    > legsArray of objects組合交易
    >> categorystring類型,有效值包括:linearoptionspot
    >> symbolstring唯一的交易品種 ID
    >> sidestring詢價方向,有效值包括 BuySell
    >> qtystring交易品種的訂單數量

    請求示例

    GET /v5/rfq/rfq-realtime HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1676430842094
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXXX

    響應示例

    {
    "retCode": 0,
    "retMsg": "OK",
    "result": {
    "list": [
    {
    "rfqLinkId": "",
    "rfqId": "1756885055799241492396882271696580",
    "counterparties": [
    "hashwave2"
    ],
    "strategyType": "custom",
    "expiresAt": "1756885655801",
    "status": "Active",
    "deskCode": "1nu9d1",
    "createdAt": "1756885055801",
    "updatedAt": "1756885055801",
    "legs": [
    {
    "category": "linear",
    "symbol": "BTCUSDT",
    "side": "Buy",
    "qty": "1"
    }
    ]
    }
    ]
    },
    "retExtInfo": {},
    "time": 1756885059062
    }