跳至主要内容

報價

建立報價。每秒最多 50 次請求

信息
  • 僅支持 UTA2.0 帳戶
  • 無法對自己提出的詢價進行報價
  • 一個請求報價包含兩個方向
  • 至少需傳遞 quoteBuyList 或 quoteSellList
  • 若需進行現貨報價，請先通過 設置抵押品幣種 或 批量設置抵押品幣種 啟用相應的抵押幣種

HTTP 請求​

POST /v5/rfq/create-quote

請求參數​

參數是否必需類型說明
rfqIdtruestring詢價單 ID
quoteLinkIdfalsestring報價自定義 ID：
  • 長度應介於 1-32 位
  • 字母（區分大小寫）與數字的組合，可以是純字母或純數字
  • 指定 quoteLinkId 僅檢查最近 3 個月的資料
  • 非終端狀態僅能保證在 24 小時內的唯一性，而終端狀態不保證唯一性
anonymousfalseboolean是否為匿名報價，true 表示匿名報價，false 表示公開報價，預設值為 false ，當為 true 時，即使交易執行後，身份也不會透露給詢價方。
expireInfalseinteger報價的有效持續時間（以秒為單位）. [10, 120]. 默認: 60
quoteBuyListfalsearray of objects買入方向，報價方向為 Buy，對於 maker（報價方），執行方向與 legs 中的方向一致，對於 taker（詢價方）則相反
> categorytruestring產品類型：統一帳戶：spot, linear, option
> symboltruestring交易合約名稱
> pricetruestring報價價格
quoteSellListfalsearray of objects賣出方向，報價方向為 Sell，對於 maker（報價方），執行方向與 legs 中的方向相反，對於 taker（詢價方）則一致
> categorytruestring產品類型：統一帳戶：spot, linear, option
> symboltruestring交易合約名稱
> pricetruestring報價價格

響應參數​

參數類型說明
resultobject
> rfqIdstring詢價單 ID
> quoteIdstring報價單 ID
> quoteLinkIdstring報價自定義 ID
> expiresAtstring報價單的到期時間，為 Unix 時間戳的毫秒格式
> deskCodestring報價方唯一識別碼
> statusstring報價單狀態：Active Canceled Filled Expired Failed

請求示例​

POST /v5/rfq/create-quote 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

{
  "rfqId":"1754364447601610516653123084412812", 
  "quoteBuyList": [
        {
            "category": "linear",
            "symbol": "BTCUSDT",
            "price": "106000"
        }
    ],
    "quoteSellList":[
        {
            "category": "linear",
            "symbol": "BTCUSDT",
            "price": "126500"
        }
    ]
}

響應示例​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "rfqId": "175740578143743543930777169307022",
        "quoteId": "1757405933130044334361923221559805",
        "quoteLinkId": "",
        "expiresAt": "1757405993126",
        "deskCode": "test0904",
        "status": "Active"
    },
    "retExtInfo": {},
    "time": 1757405933132
}