跳至主要内容

報價

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

信息
  • 一個請求報價包含兩個方向
  • 至少需傳遞 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
    }