Get Strategy List

Query the strategy list. Supports filtering by strategy ID, symbol, status, category, and strategy type.
You can also subscribe strategy stream to receive the feed.

HTTP Request

GET/v5/strategy/list

Request Parameters

Parameter	Required	Type	Comments
strategyId	false	string	Strategy ID (exact match)
symbol	false	string	Symbol name, e.g. BTCUSDT
status	false	string	Strategy status. 2: running, 3: terminated, 4: terminated but orders are not filled, 5: paused, 6: untriggered
category	false	string	Product type. UTA_USDT, UTA_USDC, UTA_USDC_FUTURE, UTA_SPOT, UTA_INVERSE, UTA_INVERSE_FUTURE, UTA_USDT_FUTURE
strategyType	false	string	Strategy type. twap, chaseOrder, iceberg
beginTimeE0	false	int64	Start time in seconds (Unix timestamp)
endTimeE0	false	int64	End time in seconds (Unix timestamp)
pageSize	false	integer	Limit for data size per page. Default: 20, max: 50
cursor	false	string	Cursor for pagination, returned from the previous response

Response Parameters

Parameter	Type	Comments
list	array	Object
> strategyId	string	Strategy ID (UUID format)
> category	string	Product type
> symbol	string	Symbol name
> side	string	Buy, Sell
> size	string	Total order quantity
> strategyType	string	Strategy type. twap, chaseOrder, iceberg
> status	integer	Strategy status. 2: running, 3: terminated, 4: terminated but orders are not filled, 5: paused, 6: untriggered
> executedSize	string	Executed quantity
> executedAvgPrice	string	Average executed price
> executedStartTimeE3	int64	Execution start time (ms)
> executedEndTimeE3	int64	Execution end time (ms). 0 means not yet ended
> createdTimeE3	int64	Strategy creation time (ms)
> updatedTimeE3	int64	Strategy last updated time (ms)
> reduceOnly	boolean	Whether it is a reduce-only order
> triggerPrice	string	Trigger price
> isTriggered	boolean	Whether the strategy has been triggered
> leverageType	integer	Leverage type. 0: normal, 1: margin
> terminateType	integer	Termination reason code. 0: unknown, 1: user stop, 2: completed normally, 3: insufficient balance, 4: position mode changed, 5: uid blocked, 6: would trigger liquidation, 7: no position for reduce-only, 8: upgrade to UTA, 9: OI limited, 10: user trading banned, 11: risk limit exceeded, 12: symbol delivery stopped, 13: symbol delisted, 14: consecutive order failures, 15: missing template param, 16: signal latency, 17: symbol mismatch, 18: beyond max chase price, 19: max sub-order count exceeded, 20: order already cancelled, 21: max risk limit value exceeded, 22: risk limit max leverage exceeded, 23: coin not collateral, 24: reached limit price, 25: reduce-only state with pending UTA upgrade, 26: user in cooling-off period
> terminateRemark	string	Termination reason description
> triggerCount	integer	Number of trigger attempts
> tradingCount	integer	Number of actual orders placed
> realizedPnl	string	Realized PnL (futures only)
> strategyName	string	Strategy custom name
> strategyPrefer	string	Execution preference. limit, priceSpeedBalance, fastestExecution, quickExecution
> duration	integer	Total planned execution duration in seconds. TWAP only
> executedDuration	integer	Actual executed duration in seconds. TWAP only
> isRandom	boolean	Whether sub-order quantity randomization is enabled. TWAP only
> interval	integer	Sub-order placement interval in seconds. TWAP only
> limitPrice	string	Fixed limit price. Orders will not be placed beyond this price
> chasePercentE4	int64	Chase price offset in basis points (1/10000). Chase / Iceberg
> chaseDistance	string	Chase price distance (absolute value). Chase / Iceberg
> maxChasePrice	string	Maximum chase price protection. Chase / Iceberg
> chaseOrderPrice	string	Current chase order price (real-time). Chase only
> chasePrice	string	Reference price side for chase orders, e.g. Bid1, Ask1. Chase / Iceberg
> postOnly	integer	Maker-only mode. 0: taker allowed, 1: post-only. Iceberg only
> isRebalance	boolean	Whether rebalance is enabled
> orderType	integer	Order type. 1: market order, 2: limit order
> orderPriceOffset	string	Limit order price offset percentage. TWAP only
> strategySl	string	Strategy stop-loss price
> strategyTp	string	Strategy take-profit price
> arbitrageOrders	array	List of associated arbitrage orders
> positionValue	string	Total position value
> filledPositionValue	string	Filled position value
nextCursor	string	Cursor for the next page. Empty string means no more data
prevCursor	string	Cursor for the previous page

Request Example

HTTP

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

Python

Node.js

Response Example

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "list": [
            {
                "strategyId": "119b6211-2611-461b-be5e-5ac557099e82",
                "category": "UTA_USDT",
                "symbol": "BTCUSDT",
                "side": "Buy",
                "size": "0.05",
                "duration": 1560,
                "status": 3,
                "executedDuration": 1608,
                "executedSize": "0.046",
                "executedAvgPrice": "76695.48",
                "executedStartTimeE3": "1773711467045",
                "executedEndTimeE3": "1773713075628",
                "createdTimeE3": "1773711467045",
                "updatedTimeE3": "1773713075628",
                "isRandom": false,
                "limitPrice": "",
                "reduceOnly": false,
                "terminateType": 2,
                "terminateRemark": "RunningStop",
                "strategyName": "",
                "triggerCount": "26",
                "tradingCount": "0",
                "realizedPnl": "0",
                "strategyType": "twap",
                "chasePrice": "Bid1",
                "chasePercentE4": "0",
                "chaseDistance": "0",
                "maxChasePrice": "",
                "chaseOrderPrice": "",
                "arbitrageOrders": [],
                "strategyPrefer": "quickExecution",
                "isRebalance": false,
                "interval": 60,
                "leverageType": 0,
                "postOnly": 0,
                "triggerPrice": "0",
                "isTriggered": false,
                "strategyTp": "",
                "strategySl": "",
                "orderType": "UNKNOWN",
                "orderPriceOffset": "",
                "positionValue": "",
                "filledPositionValue": ""
            }
        ],
        "nextCursor": "",
        "prevCursor": ""
    },
    "retExtInfo": {},
    "time": 1774583153599
}