History Strategy Orders

Description

Get historical strategy orders

HTTP Request

• GET /api/v3/trade/history-strategy-orders
• Speed limit is 20 times/s (UID)
• Permission: UTA trade (read)

Request

curl "https://api.bitget.com/api/v3/trade/history-strategy-orders?category=usdt-futures&type=tpsl" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json" 

Request Parameters

Parameter	Type	Required	Comments
category	String	Yes	Product type SPOT Spot MARGIN Margin USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures
type	String	No	Strategy Type tpsl Take-Profit and Stop-Loss trigger Trigger Order oco OCO trailing_stop Trailing Stop iceberg Iceberg twap TWAP
startTime	String	No	Start timestamp A Unix timestamp in milliseconds e.g.,1597026383085
endTime	String	No	End timestamp A Unix timestamp in milliseconds e.g.,1597026383085
limit	String	No	Limit per page Default:100. Maximum:100
cursor	String	No	Cursor Pagination is implemented by omitting the cursor in the first query and applying the cursor from the previous query for subsequent pages

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1730186730084,
  "data": {
    "list": [
      {
        "orderId": "111111111111111111",
        "clientOid": "111111111111111111",
        "category": "USDT-FUTURES",
        "symbol": "BTCUSDT",
        "qty": "0.01",
        "posSide": "long",
        "status": "success",
        "tpTriggerBy": "market",
        "slTriggerBy": "market",
        "takeProfit": "110000",
        "stopLoss": "90000",
        "tpOrderType": "market",
        "slOrderType": "market",
        "tpLimitPrice": "91000",
        "slLimitPrice": "111000",
        "triggerBy": "market",
        "triggerPrice": "100000",
        "triggerOrderType": "limit",
        "triggerOrderPrice": "100500",
        "createdTime": "1730186725663",
        "updatedTime": "1730186725691"
      }
    ],
    "cursor": 1233319323918499840
  }
}

Response Parameters

Parameter	Type	Comments
list	Array	Order list
>orderId	String	Order ID
>clientOid	String	Client order ID
>category	String	Product type USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures
>symbol	String	Symbol name e.g.,BTCUSDT
>qty	String	Order Quantity
>posSide	String	Position side long/short
>status	String	Strategy order status pending Waiting to be executed success Executed failed Execution failed cancelled Cancelled submitting Submitting
>triggerType	String	Trigger Type takeProfitTake-Profit stopLossStop-Loss
>tpTriggerBy	String	Take-Profit Trigger Type market: Market Price mark: Mark Price
>slTriggerBy	String	Stop-Loss Trigger Type market: Market Price mark: Mark Price
>takeProfit	String	Take-Profit Trigger Price
>stopLoss	String	Stop-Loss Trigger Price
>tpOrderType	String	Take-Profit Trigger Strategy Order Type limit: Limit Order market: Market Order
>slOrderType	String	Stop-Loss Trigger Strategy Order Type limit: Limit Order market: Market Order
>tpLimitPrice	String	Take-Profit Strategy Order Execution Price
>slLimitPrice	String	Stop-Loss Strategy Order Execution Price
>triggerBy	String	Trigger order trigger price type market: Market Price mark: Mark Price
>triggerPrice	String	Trigger order trigger price
>triggerOrderType	String	Trigger order type limit: Limit Order market: Market Order
>triggerOrderPrice	String	Trigger order execution price
>ocoParams	List<String>	OCO parameters list Returned when type=oco
>>ocoLimitPrice	String	Limit order price for OCO
>>ocoTriggerPrice	String	Trigger price for the conditional order leg
>>ocoOrderType	String	Order type for the conditional order leg limit: Limit Order market: Market Order
>>ocoOrderPrice	String	Execution price for the conditional order leg
>trailingStopParams	List<String>	Trailing stop parameters list Returned when type=trailing_stop
>>activationPrice	String	Activation price
>>activationType	String	Activation price type market: Market Price mark: Mark Price index: Index Price
>>trailType	String	Trailing mode ratio: Percentage spread: Spread
>>trailVariance	String	Trailing variance
>>preOrderType	String	Preset order type limit: Limit Order market: Market Order
>>preOrderPrice	String	Preset order price
>icebergParams	List<String>	Iceberg parameters list Returned when type=iceberg
>>splitMode	String	Split mode quantity: By quantity per sub-order order: By number of sub-orders
>>qtyPerOrder	String	Quantity per sub-order
>>splitOrderNumbers	String	Number of sub-orders
>>orderPreference	String	Order preference faster_execution: Faster execution fixed_distance: Fixed distance fixed_price: Fixed price
>>executionStrategy	String	Sub-order execution strategy queue1: Same-direction price 1 counterparty1: Counterparty price 1
>>fixedDistanceType	String	Fixed distance type spread: By spread percentage: By percentage
>>distance	String	Distance value
>>fixedPrice	String	Fixed price for sub-orders
>>priceLimit	String	Price protection limit
>twapParams	List<String>	TWAP parameters list Returned when type=twap
>>duration	String	Total duration in minutes
>>interval	String	Frequency in seconds
>>orderType	String	Sub-order type market: Market Order limit: Limit Order
>>limitOffsetType	Number	Limit offset type percentage: Percentage spread: Spread
>>limitOffsetPercentage	Number	Limit offset percentage
>>limitOffsetSpread	Number	Limit offset spread
>>twapTriggerPrice	Number	Strategy trigger price
>>twapTerminationPrice	Number	Strategy termination price
>createdTime	String	Order created timestamp A Unix millisecond timestamp
>updatedTime	String	Order update timestamp A Unix millisecond timestamp
cursor	Number	Cursor for next page Pass this value as the cursor parameter in the next request to get the next page of data