獲取歷史詢價資訊

獲取歷史詢價資訊。每秒最多 50 次請求

信息

獲取使用者發送或接收的詢價資訊，從資料庫查詢，存在延遲

同時傳遞 rfqId 和 rfqLinkId 時，以 rfqId 為準

根據詢價單的創建時間倒序排列並返回。

HTTP 請求

GET /v5/rfq/rfq-list

請求參數

參數	是否必需	類型	說明
rfqId	false	string	詢價單 ID
rfqLinkId	false	string	詢價單自定義 ID；指定 rfqLinkId 僅能查詢最近 3 個月的數據，當 traderType 為 quote 時，此字段無效
traderType	false	string	交易者類型，quoter 或 request，默認為 request Request：詢價方，查詢自己發出的詢價單 Quoter：報價方，查詢自己接收到的報價單
status	false	string	詢價單狀態：Active、Canceled、Filled、Expired、Failed
limit	false	integer	返回的項目數量，最多 100 項，默認 50 項
cursor	false	string	分頁標記，請使用返回的 cursor，簽名時使用返回的原始數據，發送請求時進行 URLEncode

響應參數

參數	類型	說明
result	array	Object
> cursor	string	分頁標記
> list	Array	詢價單數據陣列
>> rfqId	string	詢價單 ID
>> rfqLinkId	string	自定義詢價單 ID，客戶敏感資訊不會公開，僅返回給報價方。
>> counterparties	Array of strings	報價方列表
>> expiresAt	string	詢價單的過期時間，Unix 時間戳的毫秒格式
>> strategyType	string	詢價標籤
>> status	string	詢價單狀態：Active、PendingFill、Canceled、Filled、Expired、Failed
>> deskCode	string	詢價方的唯一識別代碼，若詢價時設置匿名為 true 則不可見
>> createdAt	string	交易創建的時間（毫秒），例如 1650380963
>> updatedAt	string	交易更新的時間（毫秒），例如 1650380964
>> legs	Array of objects	組合交易
>>> category	string	類型，有效值包括：linear、option 和 spot
>>> symbol	string	唯一的交易品種 ID
>>> side	string	詢價方向，有效值包括 Buy 和 Sell
>>> qty	string	交易品種的訂單數量

請求示例

GET /v5/rfq/rfq-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": [
            {
                "rfqLinkId": "",
                "rfqId": "1756885055799241492396882271696580",
                "counterparties": [
                    "hashwave2"
                ],
                "strategyType": "custom",
                "expiresAt": "1756885655801",
                "status": "Active",
                "deskCode": "1nu9d1",
                "createdAt": "1756885055801",
                "updatedAt": "1756885055801",
                "legs": [
                    {
                        "category": "linear",
                        "symbol": "BTCUSDT",
                        "side": "Buy",
                        "qty": "1"
                    }
                ]
            },
            {
                "rfqLinkId": "",
                "rfqId": "1756874158983736854420161904593980",
                "counterparties": [
                    "hashwave2"
                ],
                "strategyType": "custom",
                "expiresAt": "1756874758985",
                "status": "Expired",
                "deskCode": "1nu9d1",
                "createdAt": "1756874158985",
                "updatedAt": "1756874764046",
                "legs": [
                    {
                        "category": "linear",
                        "symbol": "BTCUSDT",
                        "side": "Buy",
                        "qty": "1"
                    }
                ]
            },
            {
                "rfqLinkId": "",
                "rfqId": "1756871488168105512459181956436945",
                "counterparties": [
                    "hashwave2"
                ],
                "strategyType": "custom",
                "expiresAt": "1756872088171",
                "status": "Canceled",
                "deskCode": "1nu9d1",
                "createdAt": "1756871488171",
                "updatedAt": "1756871494505",
                "legs": [
                    {
                        "category": "linear",
                        "symbol": "BTCUSDT",
                        "side": "Buy",
                        "qty": "1"
                    }
                ]
            }
        ]
    },
    "retExtInfo": {},
    "time": 1756885352116
}