跳至主要内容

獲取交易資訊

獲取交易資訊。每秒最多 50 次請求

信息
  • 字段查詢優先級:rfqId > rfqLinkId > quoteId > quoteLinkId
  • HTTP 請求

    GET /v5/rfq/trade-list

    請求參數

    參數是否必需類型說明
    rfqIdfalsestring詢價單 ID
    rfqLinkIdfalsestring自定義詢價單 ID;指定 rfqLinkId 僅能查詢最近 3 個月的數據
    quoteIdfalsestring報價單 ID
    quoteLinkIdfalsestring自定義報價單 ID;指定 quoteLinkId 僅能查詢最近 3 個月的數據
    traderTypefalsestring交易者類型,quoterequest,默認為 quote
  • Request:詢價方,查詢自己詢價單的成功交易
  • Quote:報價方,查詢自己報價單的成功交易
  • statusfalsestring狀態:FilledFailed
    limitfalseinteger返回的項目數量,最多 100 項,默認 50 項
    cursorfalsestring分頁標記,請使用返回的 cursor,簽名時使用返回的原始數據,發送請求時進行 URLEncode

    響應參數

    參數類型說明
    resultObject
    > cursorstring分頁標記
    > listArray詢價單數據陣列
    >> rfqIdstring詢價單 ID
    >> rfqLinkIdstring自定義詢價單 ID,客戶敏感資訊不會公開,僅返回給報價方。
    >> quoteIdstring返回已完成的詢價單及執行的報價單 ID
    >> quoteLinkIdstring自定義報價單 ID,客戶敏感資訊不會公開,僅返回給詢價方。
    >> quoteSidestring返回已完成詢價單的執行方向,BuySell
    >> strategyTypestring詢價標籤
    >> statusstring狀態:FilledFailed
    >> rfqDeskCodestring詢價方的唯一識別代碼,若詢價時設置匿名為 true 則不可見
    >> quoteDeskCodestring報價方的唯一識別代碼,若報價時設置匿名為 true 則不可見
    >> createdAtstring交易創建的時間(毫秒),例如 1650380963
    >> updatedAtstring交易更新的時間(毫秒),例如 1650380964
    >> legsArray of objects組合交易
    >>> categorystring類型,有效值包括:linearoptionspot
    >>> orderIdstringBybit 訂單 ID
    >>> symbolstring唯一的交易品種 ID
    >>> sidestring方向,有效值包括 BuySell
    >>> pricestring執行價格
    >>> qtystring執行數量
    >>> markPricestring交易時的期貨標記價格,現貨為指數價格,期權為標的價格的標記價格
    >>> execFeestring支付給執行該交易的交易所的基礎貨幣的 taker 或 maker 費用
    >>> execIdstring交易所唯一的執行交易 ID
    >>> resultCodeinteger該訂單的狀態碼,"0" 表示成功
    >>> resultMessagestring關於 resultCode 的錯誤信息。如果 resultCode 為 "0",則 resultMessage 為空字符串
    >>> rejectPartystring若狀態為 Filled 則為空。若狀態為 Rejected,有效值包括 TakerMaker,"rejectParty='bybit'" 表示錯誤發生在 Bybit 端。

    請求示例

    GET /v5/rfq/trade-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": "1755159541420049734454484077021786",
    "quoteId": "175515955714692291558309160384918",
    "quoteSide": "Buy",
    "strategyType": "PerpBasis",
    "status": "Failed",
    "rfqDeskCode": "1nu9d1",
    "quoteDeskCode": "lines100412673",
    "legs": [
    {
    "category": "linear",
    "symbol": "BTCUSDT-15AUG25",
    "side": "Sell",
    "price": "108887",
    "qty": "1",
    "orderId": "db852bcd-052e-49b7-ba10-059622e1219b",
    "markPrice": "",
    "execFee": "0",
    "execId": "",
    "resultCode": 111002,
    "resultMessage": "Rejected caused by another legs",
    "rejectParty": ""
    },
    {
    "category": "linear",
    "symbol": "BTCUSDT",
    "side": "Buy",
    "price": "132038",
    "qty": "1",
    "orderId": "69667acb-7048-48d7-90b9-ccbdfd423130",
    "markPrice": "",
    "execFee": "0",
    "execId": "",
    "resultCode": 110007,
    "resultMessage": "Insufficient available balance",
    "rejectParty": "taker"
    }
    ],
    "createdAt": "1755159541421",
    "updatedAt": "1755159654501"
    }
    ]
    },
    "retExtInfo": {},
    "time": 1756891941267
    }