Skip to main content

Get Strategy Order List

Query the individual orders generated by a specific strategy.

HTTP Request​

GET/v5/strategy/order-list

Request Parameters​

ParameterRequiredTypeComments
strategyIdtruestringStrategy ID
statusfalsestringOrder status filter. 2: created, 3: create failed, 4: partially filled, 5: fully filled, 6: rejected, 7: canceled
symbolfalsestringSymbol name, e.g. BTCUSDT
strategyTypefalsestringStrategy type. twap, chaseOrder, iceberg, pov
beginTimeE0falseint64Start time in seconds (Unix timestamp). The range between beginTimeE0 and endTimeE0 cannot exceed one year
endTimeE0falseint64End time in seconds (Unix timestamp). The range between beginTimeE0 and endTimeE0 cannot exceed one year
pageSizefalseintegerLimit for data size per page. Default: 20
cursorfalsestringCursor for pagination, returned from the previous response

Response Parameters​

ParameterTypeComments
listarrayObject
> strategyIdstringStrategy ID
> orderIdstringOrder ID (exchange-assigned)
> symbolstringSymbol name
> sidestringBuy, Sell
> sizestringOrder quantity
> pricestringOrder price
> statusstringOrder status. 2: created, 3: create failed, 4: partially filled, 5: fully filled, 6: rejected, 7: canceled
> executedSizestringExecuted quantity
> dealTimeE3int64Deal time (ms). 0 means not yet filled
> parentOrderIdstringParent order ID. Used in retry scenarios to identify the original order
> createdTimeE3int64Order creation time (ms)
> updatedTimeE3int64Order last updated time (ms)
> codeintegerError code. 0 means success
> msgstringError message
> categorystringProduct type
> positionIdxintegerPosition index. 0: one-way mode, 1: buy side of hedge mode, 2: sell side of hedge mode
> orderTypeintegerOrder type. 1: market order, 2: limit order
> leverageTypeintegerLeverage type. 0: normal, 1: margin
> tpPricestringOrder take-profit price
> slPricestringOrder stop-loss price
> orderPriceOffsetstringLimit order price offset percentage
> positionValuestringTotal position value
> filledPositionValuestringFilled position value
nextCursorstringCursor for the next page. Empty string means no more data
prevCursorstringCursor for the previous page

Request Example​

GET /v5/strategy/order-list?strategyId=119b6211-2611-461b-be5e-5ac557099e82&pageSize=2 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1773718074685
X-BAPI-RECV-WINDOW: 5000

Response Example​

{
"retCode": 0,
"retMsg": "success",
"result": {
"list": [
{
"strategyId": "119b6211-2611-461b-be5e-5ac557099e82",
"orderId": "d67e97b1-7a6e-4a89-b9d7-098756e8b86f",
"symbol": "BTCUSDT",
"side": "Buy",
"size": "0.004",
"price": "",
"status": "3",
"executedSize": "0",
"dealTimeE3": "0",
"parentOrderId": "276a053f-fedf-4834-bbab-d5fc3bc0dc94",
"createdTimeE3": "1773713015709",
"updatedTimeE3": "1773713020768",
"code": 30208,
"msg": "Failed to submit order(s). The order price is higher than the maximum buying price.",
"category": "UTA_USDT",
"positionIdx": 0,
"leverageType": 0,
"tpPrice": "",
"slPrice": "",
"orderType": "UNKNOWN",
"orderPriceOffset": "0",
"positionValue": "",
"filledPositionValue": ""
},
{
"strategyId": "119b6211-2611-461b-be5e-5ac557099e82",
"orderId": "276a053f-fedf-4834-bbab-d5fc3bc0dc94",
"symbol": "BTCUSDT",
"side": "Buy",
"size": "0.004",
"price": "",
"status": "7",
"executedSize": "0",
"dealTimeE3": "0",
"parentOrderId": "",
"createdTimeE3": "1773713015400",
"updatedTimeE3": "1773713015701",
"code": 60068,
"msg": "",
"category": "UTA_USDT",
"positionIdx": 0,
"leverageType": 0,
"tpPrice": "",
"slPrice": "",
"orderType": "UNKNOWN",
"orderPriceOffset": "0",
"positionValue": "",
"filledPositionValue": ""
}
],
"nextCursor": "eyJPZmZzZXQiOjIwMzM3MjU5MDU4MjU4NTM0NDAsIlBhZ2VTaXplIjoyLCJycGNDdXJzb3IiOiIifQ==",
"prevCursor": ""
},
"retExtInfo": {},
"time": 1774590281733
}