Skip to main content

Get Delivery Record

Query delivery records of USDC futures and Options, sorted by deliveryTime in descending order

Unified account covers: USDC futures / Option

HTTP Request

GET /v5/asset/delivery-record

Request Parameters

ParameterRequiredTypeComments
categorytruestringProduct type. option, linear
symbolfalsestringSymbol name
startTimefalseintegerThe start timestamp (ms)
  • startTime and endTime are not passed, return 30 days by default
  • Only startTime is passed, return range between startTime and startTime+30 days
  • Only endTime is passed, return range between endTime-30 days and endTime
  • If both are passed, the rule is endTime - startTime <= 30 days
endTimefalseintegerThe end time. timestamp (ms)
expDatefalsestringExpiry date. 25MAR22. Default: return all
limitfalseintegerLimit for data size per page. [1, 50]. Default: 20
cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

ParameterTypeComments
categorystringProduct type
listarrayObject
> deliveryTimenumberDelivery time (ms)
> symbolstringSymbol name
> sidestringBuy,Sell
> positionstringExecuted size
> deliveryPricestringDelivery price
> strikestringExercise price
> feestringTrading fee
> deliveryRplstringRealized PnL of the delivery
nextPageCursorstringRefer to the cursor request parameter

Request Example

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

Response Example

{
"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
}