跳至主要内容

詢價

創建詢價單 每秒最多 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 時，即使交易執行後，身份也不會透露給報價方。當 anonymous 為 true 時，獲取詢價單 返回的 deskCode 為空字串
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，則反向開倉
hedgefalsearray of objectsDelta Hedge 腿對象（單個對象，非陣列）；整個 hedge 對象均為可選，不填則本筆 RFQ 無 hedge 腿
> categorytruestring產品類型，初期僅支持 linear（永續合約 / 線性交割期貨）
> symboltruestring對冲合約名稱，如 BTCUSDT（永續）或 BTC-27JUN25（線性交割期貨）。底層資產須與主策略腿（list）一致，不支持跨資產對冲
> sidetruestring詢價單交易方向：Buy, Sell
> qtytruestring交易數量，超過倉位的 Size，則反向開倉
> pricefalsestringTaker 期望的 Delta Hedge 執行價格，僅作為參考透傳給做市商；Maker 可在 create-quote 中覆蓋此價格。價格校驗復用主網現有衍生品限價邏輯，超限自動修正

響應參數​

參數類型說明
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": ["SPMAKERTEST"],
    "rfqLinkId": "V2-Integration-Test-RFQ",
    "anonymous": false,
    "strategyType": "custom",
    "list": [
        {
            "category": "option",
            "symbol": "BTC-25JUL25-100000-C",
            "side": "Buy",
            "qty": "100"
        }
    ],
    "hedge": [
        {
            "category": "linear",
            "symbol": "BTCUSDT",
            "side": "Sell",
            "qty": "46",
            "price": "121500.0"
        }
    ]
}

響應示例​

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