跳至主要内容

查詢交割紀錄

查詢反向交割 / USDC交割 / 期權的交割紀錄, 返回結果按照deliveryTime降序排列

HTTP 請求

GET /v5/asset/delivery-record

請求參數

參數是否必需類型說明
categorytruestring產品類型
  • 統一帳戶2.0: inverse(反向交割), linear(USDC交割), option
  • 統一帳戶1.0: linear(USDC交割), option
  • symbolfalsestring合約名稱
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近30天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 30天
    • 若只傳startTime,則查詢startTime和startTime+30天的數據
    • 若只傳endTime,則查詢endTime-30天和endTime的數據
    endTimefalseinteger結束時間 (毫秒)
    expDatefalsestring過期日. 格式示例: 25MAR22. 默認: 返回所有日期數據
    limitfalseinteger每頁數量限制. [1, 50]. 默認: 20
    cursorfalsestring游標,用於翻頁

    響應參數

    參數類型說明
    categorystring產品類型
    listarrayObject
    > deliveryTimenumber交割時間戳 (毫秒)
    > symbolstring合約名稱
    > sidestringBuy,Sell
    > positionstring交割數量
    > deliveryPricestring交割價格
    > strikestring行權價
    > feestring手續費,正數表支出,負數表收取
    > deliveryRplstring交割已實現盈虧
    nextPageCursorstring游標,用於翻頁

    請求示例

    GET /v5/asset/delivery-record?expDate=29DEC22&category=option HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672362112944
    X-BAPI-RECV-WINDOW: 5000

    響應示例

    {
    "retCode": 0,
    "retMsg": "OK",
    "result": {
    "nextPageCursor": "132791%3A0%2C132791%3A0",
    "category": "option",
    "list": [
    {
    "symbol": "BTC-29DEC22-16000-P",
    "side": "Buy",
    "deliveryTime": 1672300800860,
    "strike": "16000",
    "fee": "0.00000000",
    "position": "0.01",
    "deliveryPrice": "16541.86369547",
    "deliveryRpl": "3.5"
    }
    ]
    },
    "retExtInfo": {},
    "time": 1672362116184
    }