跳至主要内容

詢價

創建詢價單 每秒最多 50 次請求

信息
  • 僅支持 UTA2.0 帳戶
  • 僅支持全倉與組合保證金模式
  • 不支持模擬用戶
  • 不能選擇自己作為報價方

HTTP 請求

POST /v5/rfq/create-rfq

請求參數

參數是否必需類型說明
counterpartiestrueArray of deskCode希望接收詢價的報價方列表,可透過 /v5/rfq/config獲取
rfqLinkIdfalsestring自定義詢價單 ID:
  • 長度應介於 1-32 位
  • 字母(區分大小寫)與數字的組合,可以是純字母或純數字
  • 指定 rfqLinkId 僅檢查最近 3 個月的資料
  • 非終端狀態僅能保證在 24 小時內的唯一性,而終端狀態不保證唯一性
anonymousfalseboolean是否為匿名詢價,true 表示匿名詢價,false 表示公開詢價,預設值為 false ,當為 true 時,即使交易執行後,身份也不會透露給報價方。
strategyTypefalsestring策略類型,若為自定義詢價,strategyType 為 custom,若為系統提供的產品,則為組合類型;預設為 custom;非自定義組合具有費率優化,目前為 50%;LP 之間的交易費率目前為 30%
listtruearray of objects組合交易清單
  • 通過 rfq配寘資訊 確認所提供的最大腿數 (maxLegs)
  • 所有組合的 basecoin 和 settleCoin 必須相同
  • 同類型下的 symbol 必須唯一
> categorytruestring產品類型:統一帳戶:spot, linear, option
> symboltruestring交易合約名稱,合約結算前 30 分鐘不允許詢價
> sidetruestring詢價交易方向:Buy , Sell
> qtytruestring交易數量,超過倉位的Size,則反向開倉

響應參數

參數類型說明
resultarray訂單 ID
listarray<object>
> rfqIdstring詢價單 ID
> rfqLinkIdstring自定義詢價單 ID
> statusstring詢價單狀態: Active Canceled Filled Expired Failed
> expiresAtstring詢價單的到期時間,為 Unix 時間戳的毫秒格式
> deskCodestring詢價方唯一識別碼

請求示例

POST /v5/rfq/create-rfq HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1744083949347
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 115

{
"counterparties": ["LP4","LP5"],
"rfqLinkId":"rfq00993",
"anonymous": false,
"strategyType": "custom",
"list": [
{
"category": "linear",
"symbol": "BTCUSDT",
"side":"buy",
"qty":"2"
},
{
"category": "spot",
"symbol": "BTCUSDT",
"side":"buy",
"qty":"2"
},
{
"category": "option",
"symbol": "BTCUSDT",
"side":"sell",
"qty":"2"
}
]
}

響應示例

{
"retCode": 0,
"retMsg": "OK",
"result": {
"rfqId": "17526315514105706281",
"rfqLinkId": "rfq00993",
"status": "Active",
"expiresAt": "1752632151414",
"deskCode": "LP2"
},
"retExtInfo": {},
"time": 1752631551419
}