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)
|
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
}