Get Execution Record

Query users' execution records, sort by execTime in descending order

tip

• You may have multiple executions in a single order.
• This endpoint can query half-year data.

HTTP Request

POST /unified/v3/private/execution/list

Request Parameters

Parameter	Required	Type	Comments
category	true	string	Product type. linear,option
symbol	false	string	Symbol name
orderId	false	string	Order id
orderLinkId	false	string	User customised order id
baseCoin	false	string	Base coin. For option only. Return all base coin data if not passed
startTime	false	integer	The start timestamp (ms)
endTime	false	integer	The end timestamp (ms)
execType	false	string	Execution type
direction	false	string	prev: previous page, next: next page. Default: next
limit	false	integer	Limit for data size per page. [1, 100]. Default: 50
cursor	false	string	Cursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

Parameter	Type	Comments
category	string	Product type. linear,option
list	array	Object
> symbol	string	Symbol name
> orderId	string	Order id
> orderLinkId	string	User customized order id
> side	string	Side. Buy,Sell
> orderPrice	string	Order price
> orderQty	string	Order qty
> leavesQty	string	The remaining qty not executed
> orderType	string	Order type. Market,Limit
> stopOrderType	string	Stop order type. If the order is not stop order, any type is not returned
> execFee	string	Executed trading fee
> execId	string	Execution id
> execPrice	string	Execution price
> execQty	string	Execution qty
> execType	string	Executed type
> execValue	string	Executed order value
> execTime	number	Executed timestamp（ms）
> feeRate	string	Trading fee rate
> blockTradeId	string	Paradigm block trade id
nextPageCursor	string	Cursor. Used to pagination

Request Example

GET /unified/v3/private/execution/list?category=option&symbol=ETH-30DEC22-700-C HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672020216382
X-BAPI-RECV-WINDOW: 5000

Response Example

{
    "retCode": 0,
    "retMsg": "Success",
    "result": {
        "nextPageCursor": "2203%3A0%2C2203%3A0",
        "category": "option",
        "list": [
        {
            "orderType": "Market",
            "symbol": "ETH-30DEC22-700-C",
            "orderLinkId": "",
            "side": "Sell",
            "orderId": "cc8012bc-ddc1-443c-8dd9-88cfb946d3b0",
            "leavesQty": "0.0000",
            "execTime": 1672018465365,
            "execFee": "0.03656010",
            "feeRate": "0.000300",
            "execId": "f4309658-62be-5f2b-b262-852909c45bba",
            "blockTradeId": "",
            "execPrice": "498.00000000",
            "lastLiquidityInd": "TAKER",
            "orderQty": "0.1000",
            "orderPrice": "496.50000000",
            "execValue": "49.80000000",
            "execType": "Trade",
            "execQty": "0.1000"
        }
    ]
},
    "retExtInfo": {},
    "time": 1672019908409
}