Get Execution List

Query users' execution list, sort by execTime in descending order. Support USDT Perpetual, Inverse Perpetual, Inverse Future, USDC Perpetual and USDC Option.

Query time range:

• USDT perp, Inverse perp, Inverse future: up to 2 years

tip

You may have multiple executions in a single order.

HTTP Request

GET /contract/v3/private/execution/list

Request Parameters

Parameter	Required	Type	Comments
symbol	true	string	Symbol name
orderId	false	string	Order ID. Return all records if not passed
startTime	false	integer	The start timestamp (ms) startTime and endTime are not passed, return 7 days by default Only startTime is passed, return range between startTime and startTime+7 days Only endTime is passed, return range between endTime-7 days and endTime If both are passed, the rule is endTime - startTime <= 7 days
endTime	false	integer	The end timestamp (ms)
execType	false	string	Execution type
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
nextPageCursor	string	Cursor. Used to pagination
list	array	Object
> symbol	string	Symbol name
> side	string	Buy,Sell
> orderId	string	Order id
> orderLinkId	string	User customised order id
> orderPrice	string	Order price
> orderQty	string	Order qty
> orderType	string	Market,Limit
> stopOrderType	string	Stop order type
> execId	string	Trade Id
> execPrice	string	Execution price
> execQty	string	Execution qty
> execFee	string	Execution fee
> execType	string	Execution type
> execValue	string	Execution position value
> feeRate	string	Trading fee rate
> lastLiquidityInd	string	AddedLiquidity, RemovedLiquidity
> isMaker	boolean	Is maker
> leavesQty	string	Remaining qty waiting for execution
> closedSize	string	Close size
> iv	string	Implied volatility
> blockTradeId	string	Block trade id
> markPrice	string	Mark price
> indexPrice	string	Index price
> markIv	string	Mark iv
> underlyingPrice	string	Underlying price
> execTime	string	Execution timestamp (ms)

Request Example

GET /contract/v3/private/execution/list?symbol=ETHUSDT&limit=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1670853954362
X-BAPI-RECV-WINDOW: 5000

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "symbol": "ETHUSDT",
                "execFee": "-0.08720013",
                "execId": "208751d8-f70e-4570-a5fd-d208c82af99d",
                "execPrice": "1263.77",
                "execQty": "0.69",
                "execType": "Funding",
                "execValue": "872.0013",
                "feeRate": "-0.0001",
                "lastLiquidityInd": "UNKNOWN",
                "leavesQty": "0.00",
                "orderId": "1673136000-ETHUSDT-592334-Sell",
                "orderLinkId": "",
                "orderPrice": "0.00",
                "orderQty": "0.00",
                "orderType": "UNKNOWN",
                "stopOrderType": "UNKNOWN",
                "side": "Sell",
                "execTime": "1673136000000",
                "closedSize": "0.00",
                "iv": "",
                "blockTradeId": "",
                "markPrice": "",
                "markIv": "",
                "underlyingPrice": "",
                "indexPrice": "",
                "isMaker": false
            }
        ],
        "nextPageCursor": "ZzU3NlU4M1JlLzhFTWkzeW9hemRVcitqUk4wVW9LL21KVTRWV3JPR0tYTG9uTENWSkFvUDJuWk44OVBlNnB0ZjJHTTFwdlJRV0tpZFM0Z0RzUlQ0d2FSbzVRN2lpZ0ZrZmt2UTZuRlJVSHdQSHdoYXUvdDN6aExzOEpmcDNFY2NLc2dYTnRvOXhmTmY3NVNreVgzQ2RKUFZtekptU0NQNU1rOWd5YzZRV1ZDejVFM0t0MGdlMENNc04ybzQvc2JQQ3BVRkQycHU3MFdBK3RqdFlWaVRkMTNGQmZRUUZpaVc4MkE1SnRCT09iZDRNL2FlNDVSMithdU96NTROWGFxcTFucW1MSnJSaTluM29pZm85dHVkNzJMSVQwODk4UTJLbHEybDJ0Uk9UYmtCcU5ScU9zZWRCa2Znc0dwbmNEOWJoaCtnZkRkWjlrMEl6elRmWnljeHZpYXBPWVdzZSs0UEtvdnZ4cTJHQ2JZcm1UQkU3TXFKS01yU1dmaloyT3pVS1psbmVaamh3N3Ntc0hFbEgwckxtQT09",
        "category": ""
    },
    "retExtInfo": {},
    "time": 1673150404910
}