跳至主要内容

獲取實时的詢價單資訊

獲取實时的詢價單資訊。每秒最多 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 則不可見
> anonymousboolean是否匿名
> createdAtstring交易創建的時間(毫秒),例如 1650380963
> updatedAtstring交易更新的時間(毫秒),例如 1650380964
> legsArray of objects組合交易
>> categorystring類型,有效值包括:linearoptionspot
>> symbolstring唯一的交易品種 ID
>> sidestring詢價方向,有效值包括 BuySell
>> qtystring交易品種的訂單數量
> hedgeArray of objectsDelta Hedge 腿對象
>> categorystring產品類型:統一帳戶:spot, linear, option
>> symbolstring交易合約的名稱
>> sidestring詢價單交易方向:Buy, Sell
>> qtystring交易數量,超過倉位的 Size,則反向開倉
>> pricestringTaker 期望的 Delta Hedge 執行價格,僅作為訴求透傳給做市商參考;Maker 不一定會對 hedge 腿報價。Taker 若填寫了此價格且 hedge 腿最終成交,以此價格執行

請求示例

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",
"anonymous": false,
"createdAt": "1756885055801",
"updatedAt": "1756885055801",
"legs": [
{
"category": "option",
"symbol": "BTC-25JUL25-100000-C",
"side": "Buy",
"qty": "100"
}
],
"hedge": [
{
"category": "linear",
"symbol": "BTCUSDT",
"side": "Sell",
"qty": "46",
"price": "121500.0"
}
]
}
]
},
"retExtInfo": {},
"time": 1756885059062
}