跳至主要内容

獲取歷史詢價詳情

獲取歷史詢價詳情。每秒最多 50 次請求

信息
  • 獲取使用者發出的詢價單資訊，從資料庫查詢，存在延遲
  • 同時傳遞 rfqId 和 rfqLinkId 時，以 rfqId 為準
  • 根據詢價單的創建時間倒序排列並返回

HTTP 請求​

GET/v5/rfq/rfq-detail-list

請求參數​

參數是否必需類型說明
rfqIdfalsestring詢價單 ID
rfqLinkIdfalsestring詢價單自定義 ID；指定 rfqLinkId 僅能查詢最近 3 個月的數據
statusfalsestring詢價單狀態：Active PendingFill Canceled Filled Expired Failed
traderTypefalsestring交易員類型，quote、request，默認為 request
  • request：詢價方，查詢自己發出的詢價單
  • quote：報價方，查詢自己收到的詢價單
startTimefalseinteger開始時間，毫秒
endTimefalseinteger結束時間，毫秒
limitfalseinteger返回條數，最大 100 條，默認 50 條
cursorfalsestring翻頁標記，請使用返回的 cursor；簽名時使用返回的原始數據，發送請求時進行 URLEncode

響應參數​

參數類型說明
resultobject
> cursorstring翻頁標記
> listArray詢價單數據陣列
>> rfqIdstring詢價單 ID
>> rfqLinkIdstring詢價單自定義 ID，為客戶敏感資訊，不會公開；對報價方返回空字串
>> counterpartiesArray of strings報價方列表
>> expiresAtstring詢價單的過期時間，Unix 時間戳的毫秒格式
>> strategyTypestring詢價標籤
>> statusstring詢價單狀態：Active PendingFill Canceled Filled Expired Failed
>> acceptOtherQuoteStatusboolean是否接受非 LP 報價，預設值為 false。false：不接受非 LP 報價。true：接受非 LP 報價
>> execQuoteIdstring已成交的詢價單返回，執行的報價 ID
>> execQuoteSidestring已成交的詢價單返回，執行的報價方向：Buy 或 Sell
>> deskCodestring詢價方唯一識別代碼，詢價時 anonymous 設置為 true 時不可見
>> anonymousboolean是否匿名
>> createdAtstring交易創建的時間（毫秒），例如 1650380963
>> updatedAtstring交易更新的時間（毫秒），例如 1650380964
>> legsArray of objects詢價單交易 legs
>>> categorystring類型，有效值包括：linear、option 和 spot
>>> symbolstring唯一的交易品種 ID
>>> sidestring詢價方向，有效值包括 Buy 和 Sell
>>> qtystring交易品種的訂單數量
>> hedgeArray of objectsDelta Hedge 腿對象
>>> categorystring產品類型，初期僅支持 linear（永續合約 / 線性交割期貨）
>>> symbolstring對冲合約名稱，如 BTCUSDT（永續）或 BTC-27JUN25（線性交割期貨）。底層資產須與主策略腿（legs）一致，不支持跨資產對冲
>>> sidestring詢價單交易方向：Buy, Sell
>>> qtystring交易數量，超過倉位的 Size，則反向開倉
>>> pricestringTaker 期望的 Delta Hedge 執行價格，僅作為參考透傳給做市商；Maker 可在 create-quote 中覆蓋此價格。價格校驗復用主網現有衍生品限價邏輯，超限自動修正
>> quoteListArray of objects有效報價單列表，當 traderType 為 request 時才返回
>>> quoteIdstring報價單 ID
>>> deskCodestring報價方唯一識別代碼，報價時 anonymous 設置為 true 時不可見
>>> anonymousboolean是否匿名
>>> statusstring報價單狀態：Active PendingFill Canceled Filled Expired Failed
>>> createdAtstring報價創建的時間（毫秒），例如 1650380963
>>> updatedAtstring報價更新的時間（毫秒），例如 1650380964
>>> expiresAtstring報價單的過期時間，Unix 時間戳的毫秒格式
>>> quoteBuyListArray of objects有效報價單 Buy 方向，當 traderType 為 request 時才返回
>>>> categorystring產品類型：spot、linear、option
>>>> symbolstring唯一的交易品種 ID
>>>> pricestring報價貨幣中的訂單價格
>>>> qtystring交易品種的訂單數量
>>>> isHedgeboolean是否對冲腿
>>> quoteSellListArray of objects有效報價單 Sell 方向，當 traderType 為 request 時才返回
>>>> categorystring產品類型：spot、linear、option
>>>> symbolstring交易合約的名稱
>>>> pricestring報價價格
>>>> qtystring交易品種的訂單數量
>>>> isHedgeboolean是否對冲腿
>> tradeLegsArray of objects交易成功資訊，只返回自己的交易腿資訊
>>> categorystring類型，有效值包括：linear、option 和 spot
>>> orderIdstringBybit 訂單 ID
>>> symbolstring唯一的交易品種 ID
>>> sidestring方向，有效值為 Buy 和 Sell
>>> pricestring執行價格
>>> qtystring執行數量
>>> markPricestring成交時的 markPrice；現貨為 indexPrice；期權為標的資產的 markPrice
>>> execFeestringTaker 或 Maker 支付給交易所的費用（以基礎幣種計）
>>> extraFeesstring額外費率
>>> execIdstring交易所唯一成交 ID
>>> resultCodeinteger訂單狀態碼，0 表示成功
>>> resultMessagestringresultCode 的錯誤訊息，resultCode 為 0 時為空
>>> rejectPartystring狀態為 Filled 時為空；狀態為 Rejected 時值為 Taker 或 Maker；bybit 表示 Bybit 側發生錯誤

請求示例​

GET /v5/rfq/rfq-detail-list 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": {
        "cursor": "",
        "list": [
            {
                "rfqId": "1756885055799241492396882271696580",
                "rfqLinkId": "V2-Integration-Test-RFQ",
                "counterparties": ["SPMAKERTEST"],
                "expiresAt": "1756885655801",
                "strategyType": "custom",
                "status": "Filled",
                "acceptOtherQuoteStatus": false,
                "execQuoteId": "1757405933130044334361923221559805",
                "execQuoteSide": "Buy",
                "deskCode": "1nu9d1",
                "anonymous": false,
                "createdAt": "1756885055801",
                "updatedAt": "1756885655802",
                "legs": [
                    {
                        "category": "option",
                        "symbol": "BTC-25JUL25-100000-C",
                        "side": "Buy",
                        "qty": "100"
                    }
                ],
                "hedge": [
                    {
                        "category": "linear",
                        "symbol": "BTCUSDT",
                        "side": "Sell",
                        "qty": "46",
                        "price": "121500.0"
                    }
                ],
                "quoteList": [
                    {
                        "quoteId": "1757405933130044334361923221559805",
                        "deskCode": "SPMAKERTEST",
                        "anonymous": false,
                        "status": "Filled",
                        "createdAt": "1757405933126",
                        "updatedAt": "1757405999156",
                        "expiresAt": "1757405993126",
                        "quoteBuyList": [
                            {
                                "category": "option",
                                "symbol": "BTC-25JUL25-100000-C",
                                "price": "1250.5",
                                "qty": "100",
                                "isHedge": false
                            },
                            {
                                "category": "linear",
                                "symbol": "BTCUSDT",
                                "price": "121500.0",
                                "qty": "46",
                                "isHedge": true
                            }
                        ],
                        "quoteSellList": []
                    }
                ],
                "tradeLegs": [
                    {
                        "category": "option",
                        "orderId": "1234567890123456789",
                        "symbol": "BTC-25JUL25-100000-C",
                        "side": "Buy",
                        "price": "1250.5",
                        "qty": "100",
                        "markPrice": "1248.0",
                        "execFee": "0.5",
                        "extraFees": "",
                        "execId": "abcdef1234567890abcdef",
                        "resultCode": 0,
                        "resultMessage": "",
                        "rejectParty": ""
                    }
                ]
            }
        ]
    },
    "retExtInfo": {},
    "time": 1756885352116
}