跳至主要内容

獲取實时的詢價單資訊

獲取實时的詢價單資訊。每秒最多 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
> acceptOtherQuoteStatusstring是否接受非 LP 報價. 預設值是 false.false: 不接受非 LP 報價. true: 接受非 LP 報價
> 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",
"acceptOtherQuoteStatus":"false",
"deskCode": "1nu9d1",
"createdAt": "1756885055801",
"updatedAt": "1756885055801",
"legs": [
{
"category": "linear",
"symbol": "BTCUSDT",
"side": "Buy",
"qty": "1"
}
]
}
]
},
"retExtInfo": {},
"time": 1756885059062
}