Strategy Trading

Place Strategy Order

POST

https://api.bitget.com

/api/v3/trade/place-strategy-order

Place a strategy order

API Broker rebate identifier:

The following code block needs to be added to the HTTP Header of the request.

"X-CHANNEL-API-CODE":"your-channel-api-code"

Speed limit is 10 times/s (UID)
Permission: UTA trade (read & write)

Place Strategy Order › Request Parameters

category

string · required

Product type

SPOT Spot

MARGIN Margin

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name

e.g.,BTCUSDT

type

string

Strategy Type

tpsl Take-Profit and Stop-Loss

trigger Trigger Order

oco One-Cancels-the-Other Order

trailing_stop Trailing Stop Order

iceberg Iceberg Order

twap TWAP Order

Default:tpsl

side

string

Trade side

buy/sell

Hedge-mode:

Open long: side=buy & posSide=long

Open short: side=sell & posSide=short

Close long: side=sell & posSide=long

Close short: side=buy & posSide=short

One-way mode:

Open long: side=buy

Open short: side=sell

Close long: side=sell & reduceOnly=yes

Close short: side=buy & reduceOnly=yes

posSide

string

Position side

long/short

qty

string

Order Quantity

clientOid

string

Client order ID

The idempotent validity period is six hours (not fully guaranteed)

Only valid when type=tpsl; not supported for other strategy types

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object
	type = object · requires: ocoParams
	type = object · requires: trailingStopParams
	type = object · requires: icebergParams
	type = object · requires: twapParams

Properties for tpsl:

Take-Profit and Stop-Loss (`type=tpsl`) Attach take-profit and/or stop-loss protection to an existing position. Once the market (or mark) price reaches the configured trigger price, Bitget submits a limit or market order on your behalf to close the position.

tpslMode

string

Take-Profit and Stop-Loss Mode

fullAll Positions Take-Profit and Stop-Loss

partialPartial Position Take-Profit and Stop-Loss

If left blank, the default value is full

qty

string

Order Quantity

Required when tpslMode=partial. Unit is in the base coin

reduceOnly

string

Whether it is reduce-only

yes/no

tpTriggerBy

string

Take-Profit Trigger Type

market: Market Price

mark: Mark Price

If not specified, the default value is market price

slTriggerBy

string

Stop-Loss Trigger Type

market: Market Price

mark: Mark Price

If not filled in, the default value is market 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

If not filled in, the default value is market price

slOrderType

string

Stop-Loss Trigger Strategy Order Type

limit: Limit Order

market: Market Order

If not filled in, the default value is market price

tpLimitPrice

string

Take-Profit Strategy Order Execution Price

This field is only valid for limit orders (when tpOrderType=limit); it is ignored for market orders.

slLimitPrice

string

Stop-Loss Strategy Order Execution Price

This field is only valid for limit orders (when slOrderType=limit); it is ignored for market orders

Place Strategy Order › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

Order ID

clientOid

string

Client order ID

Modify Strategy Order

POST

https://api.bitget.com

/api/v3/trade/modify-strategy-order

Modify strategy order

Speed limit is 10 times/s (UID)
Permission: UTA trade (read & write)

Modify Strategy Order › Request Parameters

orderId

string · required

Order ID

Either orderId or clientOid must be provided

If both orderId and clientOid are provided simultaneously, orderId takes higher priority

qty

string · required

Order Quantity

Can be modified under partial take-profit/stop-loss mode, and the unit is in the base coin

clientOid

string

Client order ID

Either orderId or clientOid must be provided

If both orderId and clientOid are provided simultaneously, orderId takes higher priority

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

This field is only valid for limit orders (when tpOrderType=limit); it is ignored for market orders.

slLimitPrice

string

Stop-Loss Strategy Order Execution Price

This field is only valid for limit orders (when slOrderType=limit); it is ignored for market orders

triggerBy

string

Trigger order trigger price type

market: Market Price

mark: Mark Price

triggerPrice

string

Trigger order trigger price

Only valid for limit orders (when triggerOrderType=limit)

triggerOrderType

string

Trigger order type

limit: Limit Order

market: Market Order

triggerOrderPrice

string

Trigger order execution price

Only valid for limit orders (when triggerOrderType=limit)

Modify Strategy Order › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

Order ID

clientOid

string

Client order ID

POST/api/v3/trade/modify-strategy-order

curl https://api.bitget.com/api/v3/trade/modify-strategy-order \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "orderId": "orderId",
  "clientOid": "clientOid",
  "qty": "qty",
  "tpTriggerBy": "tpTriggerBy",
  "slTriggerBy": "slTriggerBy",
  "takeProfit": "takeProfit",
  "stopLoss": "stopLoss",
  "tpOrderType": "tpOrderType",
  "slOrderType": "slOrderType",
  "tpLimitPrice": "tpLimitPrice",
  "slLimitPrice": "slLimitPrice",
  "triggerBy": "triggerBy",
  "triggerPrice": "triggerPrice",
  "triggerOrderType": "triggerOrderType",
  "triggerOrderPrice": "triggerOrderPrice"
}'

Example Request Body

{
  "orderId": "orderId",
  "clientOid": "clientOid",
  "qty": "qty",
  "tpTriggerBy": "tpTriggerBy",
  "slTriggerBy": "slTriggerBy",
  "takeProfit": "takeProfit",
  "stopLoss": "stopLoss",
  "tpOrderType": "tpOrderType",
  "slOrderType": "slOrderType",
  "tpLimitPrice": "tpLimitPrice",
  "slLimitPrice": "slLimitPrice",
  "triggerBy": "triggerBy",
  "triggerPrice": "triggerPrice",
  "triggerOrderType": "triggerOrderType",
  "triggerOrderPrice": "triggerOrderPrice"
}

json

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695806875837,
  "data": {
    "clientOid": "121211212122",
    "orderId": "121211212122"
  }
}

json

application/json

Cancel Strategy Order

POST

https://api.bitget.com

/api/v3/trade/cancel-strategy-order

Cancel strategy order

For iceberg/twap orders, cancelling the parent order also cancels all of its unfilled child orders. For oco orders, cancelling either leg of the pair also cancels the other leg.

Speed limit is 10 times/s (UID)
Permission: UTA trade (read & write)

Cancel Strategy Order › Request Parameters

orderId

string · required

Order ID

Either orderId or clientOid must be provided

If both orderId and clientOid are provided simultaneously, orderId takes higher priority

clientOid

string

Client order ID

Either orderId or clientOid must be provided

If both orderId and clientOid are provided simultaneously, orderId takes higher priority

Cancel Strategy Order › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

code

string

Code

msg

string

Msg

requestTime

string

Timestamp

Unfilled Strategy Orders

GET

https://api.bitget.com

/api/v3/trade/unfilled-strategy-orders

Get unfilled strategy orders

Speed limit is 20 times/s (UID)
Permission: UTA trade (read)

Unfilled Strategy Orders › Request Parameters

category

string · required

Product type

SPOT Spot

MARGIN Margin

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

type

string

Strategy Type

tpsl Take-Profit and Stop-Loss

trigger Trigger Order

oco OCO

trailing_stop Trailing Stop

iceberg Iceberg

twap TWAP

Unfilled Strategy Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

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

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

object

OCO parameters list

Returned when type=oco

object

Trailing stop parameters list

Returned when type=trailing_stop

object

Iceberg parameters list

Returned when type=iceberg

object

TWAP parameters list

Returned when type=twap

createdTime

string

Order created timestamp

A Unix millisecond timestamp

updatedTime

string

Order update timestamp

A Unix millisecond timestamp

GET/api/v3/trade/unfilled-strategy-orders

curl 'https://api.bitget.com/api/v3/trade/unfilled-strategy-orders?category=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1730186730084,
  "data": [
    {
      "orderId": "111111111111111111",
      "clientOid": "111111111111111111",
      "category": "USDT-FUTURES",
      "symbol": "BTCUSDT",
      "qty": "0.01",
      "posSide": "long",
      "status": "pending",
      "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"
    }
  ]
}

json

application/json

History Strategy Orders

GET

https://api.bitget.com

/api/v3/trade/history-strategy-orders

Get historical strategy orders

Speed limit is 20 times/s (UID)
Permission: UTA trade (read)

History Strategy Orders › Request Parameters

category

string · required

Product type

SPOT Spot

MARGIN Margin

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

type

string

Strategy Type

tpsl Take-Profit and Stop-Loss

trigger Trigger Order

oco OCO

trailing_stop Trailing Stop

iceberg Iceberg

twap TWAP

startTime

string

Start timestamp

A Unix timestamp in milliseconds e.g.,1597026383085

endTime

string

End timestamp

A Unix timestamp in milliseconds e.g.,1597026383085

limit

string

Limit per page

Default:100. Maximum:100

cursor

string

Cursor

Pagination is implemented by omitting the cursor in the first query and applying the cursor from the previous query for subsequent pages

History Strategy Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Order list

cursor

string

Cursor for next page

Pass this value as the cursor parameter in the next request to get the next page of data

GET/api/v3/trade/history-strategy-orders

curl 'https://api.bitget.com/api/v3/trade/history-strategy-orders?category=<string>'

Example Responses

{
  "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"
  }
}

json

application/json

Get Strategy Sub-orders

GET

https://api.bitget.com

/api/v3/trade/strategy-sub-orders

Get historical sub-orders generated by a strategy order

Rate limit: 10 times/s (UID)
Permission: UTA trade (read)

Get Strategy Sub-orders › Request Parameters

orderId

string · required

Strategy order ID

limit

string

Limit per page

Default:100. Maximum:100

cursor

string

Cursor

Pagination is implemented by omitting the cursor in the first query and applying the cursor from the previous query for subsequent pages

Get Strategy Sub-orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Sub-order list

cursor

integer

Cursor for next page

Pass this value as the cursor parameter in the next request to get the next page of data

Position Management Grid Trading

Place Strategy Order

POST

https://api.bitget.com

/api/v3/trade/place-strategy-order

Place a strategy order

API Broker rebate identifier:

The following code block needs to be added to the HTTP Header of the request.

"X-CHANNEL-API-CODE":"your-channel-api-code"

Speed limit is 10 times/s (UID)
Permission: UTA trade (read & write)

Place Strategy Order › Request Parameters

category

string · required

Product type

SPOT Spot

MARGIN Margin

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name

e.g.,BTCUSDT

type

string

Strategy Type

tpsl Take-Profit and Stop-Loss

trigger Trigger Order

oco One-Cancels-the-Other Order

trailing_stop Trailing Stop Order

iceberg Iceberg Order

twap TWAP Order

Default:tpsl

side

string

Trade side

buy/sell

Hedge-mode:

Open long: side=buy & posSide=long

Open short: side=sell & posSide=short

Close long: side=sell & posSide=long

Close short: side=buy & posSide=short

One-way mode:

Open long: side=buy

Open short: side=sell

Close long: side=sell & reduceOnly=yes

Close short: side=buy & reduceOnly=yes

posSide

string

Position side

long/short

qty

string

Order Quantity

clientOid

string

Client order ID

The idempotent validity period is six hours (not fully guaranteed)

Only valid when type=tpsl; not supported for other strategy types

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object
	type = object · requires: ocoParams
	type = object · requires: trailingStopParams
	type = object · requires: icebergParams
	type = object · requires: twapParams

Properties for tpsl:

tpslMode

string

Take-Profit and Stop-Loss Mode

fullAll Positions Take-Profit and Stop-Loss

partialPartial Position Take-Profit and Stop-Loss

If left blank, the default value is full

qty

string

Order Quantity

Required when tpslMode=partial. Unit is in the base coin

reduceOnly

string

Whether it is reduce-only

yes/no

tpTriggerBy

string

Take-Profit Trigger Type

market: Market Price

mark: Mark Price

If not specified, the default value is market price

slTriggerBy

string

Stop-Loss Trigger Type

market: Market Price

mark: Mark Price

If not filled in, the default value is market 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

If not filled in, the default value is market price

slOrderType

string

Stop-Loss Trigger Strategy Order Type

limit: Limit Order

market: Market Order

If not filled in, the default value is market price

tpLimitPrice

string

Take-Profit Strategy Order Execution Price

This field is only valid for limit orders (when tpOrderType=limit); it is ignored for market orders.

slLimitPrice

string

Stop-Loss Strategy Order Execution Price

This field is only valid for limit orders (when slOrderType=limit); it is ignored for market orders

Place Strategy Order › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

Order ID

clientOid

string

Client order ID

Modify Strategy Order

POST

https://api.bitget.com

/api/v3/trade/modify-strategy-order

Modify strategy order

Speed limit is 10 times/s (UID)
Permission: UTA trade (read & write)

Modify Strategy Order › Request Parameters

orderId

string · required

Order ID

Either orderId or clientOid must be provided

If both orderId and clientOid are provided simultaneously, orderId takes higher priority

qty

string · required

Order Quantity

Can be modified under partial take-profit/stop-loss mode, and the unit is in the base coin

clientOid

string

Client order ID

Either orderId or clientOid must be provided

If both orderId and clientOid are provided simultaneously, orderId takes higher priority

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

This field is only valid for limit orders (when tpOrderType=limit); it is ignored for market orders.

slLimitPrice

string

Stop-Loss Strategy Order Execution Price

This field is only valid for limit orders (when slOrderType=limit); it is ignored for market orders

triggerBy

string

Trigger order trigger price type

market: Market Price

mark: Mark Price

triggerPrice

string

Trigger order trigger price

Only valid for limit orders (when triggerOrderType=limit)

triggerOrderType

string

Trigger order type

limit: Limit Order

market: Market Order

triggerOrderPrice

string

Trigger order execution price

Only valid for limit orders (when triggerOrderType=limit)

Modify Strategy Order › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

Order ID

clientOid

string

Client order ID

Cancel Strategy Order

POST

https://api.bitget.com

/api/v3/trade/cancel-strategy-order

Cancel strategy order

For iceberg/twap orders, cancelling the parent order also cancels all of its unfilled child orders. For oco orders, cancelling either leg of the pair also cancels the other leg.

Speed limit is 10 times/s (UID)
Permission: UTA trade (read & write)

Cancel Strategy Order › Request Parameters

orderId

string · required

Order ID

Either orderId or clientOid must be provided

If both orderId and clientOid are provided simultaneously, orderId takes higher priority

clientOid

string

Client order ID

Either orderId or clientOid must be provided

If both orderId and clientOid are provided simultaneously, orderId takes higher priority

Cancel Strategy Order › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

code

string

Code

msg

string

Msg

requestTime

string

Timestamp

Unfilled Strategy Orders

GET

https://api.bitget.com

/api/v3/trade/unfilled-strategy-orders

Get unfilled strategy orders

Speed limit is 20 times/s (UID)
Permission: UTA trade (read)

Unfilled Strategy Orders › Request Parameters

category

string · required

Product type

SPOT Spot

MARGIN Margin

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

type

string

Strategy Type

tpsl Take-Profit and Stop-Loss

trigger Trigger Order

oco OCO

trailing_stop Trailing Stop

iceberg Iceberg

twap TWAP

Unfilled Strategy Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

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

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

object

OCO parameters list

Returned when type=oco

object

Trailing stop parameters list

Returned when type=trailing_stop

object

Iceberg parameters list

Returned when type=iceberg

object

TWAP parameters list

Returned when type=twap

createdTime

string

Order created timestamp

A Unix millisecond timestamp

updatedTime

string

Order update timestamp

A Unix millisecond timestamp

History Strategy Orders

GET

https://api.bitget.com

/api/v3/trade/history-strategy-orders

Get historical strategy orders

Speed limit is 20 times/s (UID)
Permission: UTA trade (read)

History Strategy Orders › Request Parameters

category

string · required

Product type

SPOT Spot

MARGIN Margin

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

type

string

Strategy Type

tpsl Take-Profit and Stop-Loss

trigger Trigger Order

oco OCO

trailing_stop Trailing Stop

iceberg Iceberg

twap TWAP

startTime

string

Start timestamp

A Unix timestamp in milliseconds e.g.,1597026383085

endTime

string

End timestamp

A Unix timestamp in milliseconds e.g.,1597026383085

limit

string

Limit per page

Default:100. Maximum:100

cursor

string

Cursor

Pagination is implemented by omitting the cursor in the first query and applying the cursor from the previous query for subsequent pages

History Strategy Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Order list

cursor

string

Cursor for next page

Pass this value as the cursor parameter in the next request to get the next page of data

Get Strategy Sub-orders

GET

https://api.bitget.com

/api/v3/trade/strategy-sub-orders

Get historical sub-orders generated by a strategy order

Rate limit: 10 times/s (UID)
Permission: UTA trade (read)

Get Strategy Sub-orders › Request Parameters

orderId

string · required

Strategy order ID

limit

string

Limit per page

Default:100. Maximum:100

cursor

string

Cursor

Pagination is implemented by omitting the cursor in the first query and applying the cursor from the previous query for subsequent pages

Get Strategy Sub-orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Sub-order list

cursor

integer

Cursor for next page

Pass this value as the cursor parameter in the next request to get the next page of data