Get Pre-upgrade Trade History

Get users' execution records which occurred before you upgraded the account to a Unified account, sorted by execTime in descending order It supports to query USDT perpetual, USDC perpetual, Inverse perpetual, Inverse futures, Spot and Option.

By category="linear", you can query USDT Perps, USDC Perps data occurred during classic account
By category="spot", you can query Spot data occurred during classic account
By category="option", you can query Options data occurred during classic account
By category="inverse", you can query Inverse Contract data occurred during classic account or UTA1.0

info

USDC Perpeual & Option support the recent 6 months data. Please download older data via GUI

deprecate plan

category=spot will be deprecated by the end of Aug, 2026.

HTTP Request

GET/v5/pre-upgrade/execution/list

Request Parameters

Parameter	Required	Type	Comments
category	true	string	Product type linear, inverse, option, spot
symbol	false	string	Symbol name, like BTCUSDT, uppercase only
orderId	false	string	Order ID
orderLinkId	false	string	User customised order ID
baseCoin	false	string	Base coin, uppercase only. Used for option
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
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	string	Executed timestamp (ms)
> isMaker	boolean	Is maker order. true: maker, false: taker
> feeRate	string	Trading fee rate
> tradeIv	string	Implied volatility
> markIv	string	Implied volatility of mark price
> markPrice	string	The mark price of the symbol when executing
> indexPrice	string	The index price of the symbol when executing
> underlyingPrice	string	The underlying price of the symbol when executing
> blockTradeId	string	Paradigm block trade ID
> closedSize	string	Closed position size
nextPageCursor	string	Refer to the cursor request parameter

Request Example

GET /v5/pre-upgrade/execution/list?category=linear&limit=1&execType=Funding&symbol=BTCUSDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1682580752432
X-BAPI-RECV-WINDOW: 5000

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "symbol": "BTCUSDT",
                "orderId": "1682553600-BTCUSDT-592334-Sell",
                "orderLinkId": "",
                "side": "Sell",
                "orderPrice": "0.00",
                "orderQty": "0.000",
                "leavesQty": "0.000",
                "orderType": "UNKNOWN",
                "stopOrderType": "UNKNOWN",
                "execFee": "0.6364003",
                "execId": "11f1c4ed-ff20-4d73-acb7-96e43a917f25",
                "execPrice": "28399.90",
                "execQty": "0.011",
                "execType": "Funding",
                "execValue": "312.3989",
                "execTime": "1682553600000",
                "isMaker": false,
                "feeRate": "0.00203714",
                "tradeIv": "",
                "markIv": "",
                "markPrice": "28399.90",
                "indexPrice": "",
                "underlyingPrice": "",
                "blockTradeId": "",
                "closedSize": "0.000"
            }
        ],
        "nextPageCursor": "page_token%3D96184191%26",
        "category": "linear"
    },
    "retExtInfo": {},
    "time": 1682580752717
}