Private

Strategy Order Channel

Description

The following events will trigger a data push:

No push on first-time subscription
Push when a strategy order is placed in the unified trading account
Push when a strategy order status changes in the unified trading account
Push when a strategy order is cancelled in the unified trading account


Code
{
    "op": "subscribe",
    "args": [
        {
            "instType": "UTA",
            "topic": "strategy-order",
            "symbol": "default"
        }
    ]
}

Request Parameters

Parameter	Type	Required	Description
op	String	Yes	Operation `subscribe` / `unsubscribe`
args	List<Object>	Yes	Subscribed channel list
> instType	String	Yes	Product type `UTA` Unified trading account
> topic	String	Yes	Topic `strategy-order` Strategy order
> symbol	String	No	Symbol name Currently only `default` is supported (all symbols)


Code
{
  "event": "subscribe",
  "arg": {
    "instType": "UTA",
    "topic": "strategy-order",
    "symbol": "default"
  },
  "connId": "xxxxxxxxxx"
}

Response Parameters

Parameters	Type	Description
event	String	Event `subscribe` / `unsubscribe` / `error`
arg	Object	Subscribed channel
> instType	String	Product type `UTA` Unified trading account
> topic	String	Topic `strategy-order` Strategy order
code	String	Error code
msg	String	Error message
connId	String	Connection ID


Code
{
  "action": "snapshot",
  "arg": {
    "instType": "UTA",
    "topic": "strategy-order",
    "symbol": "default"
  },
  "data": [
    {
      "category": "usdt-futures",
      "symbol": "BTCUSDT",
      "orderId": "111111111111111111",
      "clientOid": "myorder001",
      "qty": "0.01",
      "side": "buy",
      "posSide": "long",
      "reduceOnly": "no",
      "type": "tpsl",
      "status": "pending",
      "triggerType": "takeProfit",
      "tpTriggerBy": "market",
      "slTriggerBy": "market",
      "takeProfit": "110000",
      "stopLoss": "90000",
      "tpOrderType": "market",
      "slOrderType": "market",
      "tpLimitPrice": "",
      "slLimitPrice": "",
      "triggerBy": "market",
      "triggerPrice": "100000",
      "triggerOrderType": "limit",
      "triggerOrderPrice": "100500",
      "createdTime": "1730186725663",
      "updatedTime": "1730186725691"
    }
  ],
  "ts": 1730186725700
}

Push Parameters

Return Field	Parameter Type	Description
arg	Object	Subscribed channel
> instType	String	Product type `UTA` Unified trading account
> topic	String	Topic `strategy-order` Strategy order
action	String	Push data action `snapshot` Full data
ts	String	Push timestamp (milliseconds)
data	List<Object>	Push data
> category	String	Product type `spot` Spot `margin` Margin `usdt-futures` USDT futures `coin-futures` Coin-M futures `usdc-futures` USDC futures
> symbol	String	Symbol name
> orderId	String	Strategy order ID
> clientOid	String	Client strategy order ID
> qty	String	Order quantity
> side	String	Trade side `buy` / `sell`
> posSide	String	Position side `long` / `short`
> reduceOnly	String	Whether it is reduce-only
> type	String	Strategy type `tpsl` Take-Profit and Stop-Loss `trigger` Trigger Order
> status	String	Strategy order status `pending` Waiting to be executed `success` Executed `failed` Execution failed `cancelled` Cancelled `submitting` Submitting
> triggerType	String	Trigger type `takeProfit` Take-Profit `stopLoss` Stop-Loss
> tpTriggerBy	String	Take-Profit trigger price type `market`: Market Price `mark`: Mark Price
> slTriggerBy	String	Stop-Loss trigger price 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
> createdTime	String	Order created timestamp (Unix milliseconds)
> updatedTime	String	Order update timestamp (Unix milliseconds)

ADL Notification Channel Reality Orderbook Channel

Parameter

Type

Required

Description

String

Yes

Operation
subscribe / unsubscribe

args

List<Object>

Yes

Subscribed channel list

> instType

String

Yes

Product type
UTA Unified trading account

> topic

String

Yes

Topic
strategy-order Strategy order

> symbol

String

Symbol name
Currently only default is supported (all symbols)

Parameters

Type

Description

event

String

Event
subscribe / unsubscribe / error

arg

Object

Subscribed channel

> instType

String

Product type
UTA Unified trading account

> topic

String

Topic
strategy-order Strategy order

code

String

Error code

msg

String

Error message

connId

String

Connection ID

{
  "action": "snapshot",
  "arg": {
    "instType": "UTA",
    "topic": "strategy-order",
    "symbol": "default"
  },
  "data": [
    {
      "category": "usdt-futures",
      "symbol": "BTCUSDT",
      "orderId": "111111111111111111",
      "clientOid": "myorder001",
      "qty": "0.01",
      "side": "buy",
      "posSide": "long",
      "reduceOnly": "no",
      "type": "tpsl",
      "status": "pending",
      "triggerType": "takeProfit",
      "tpTriggerBy": "market",
      "slTriggerBy": "market",
      "takeProfit": "110000",
      "stopLoss": "90000",
      "tpOrderType": "market",
      "slOrderType": "market",
      "tpLimitPrice": "",
      "slLimitPrice": "",
      "triggerBy": "market",
      "triggerPrice": "100000",
      "triggerOrderType": "limit",
      "triggerOrderPrice": "100500",
      "createdTime": "1730186725663",
      "updatedTime": "1730186725691"
    }
  ],
  "ts": 1730186725700
}

Return Field

Parameter Type

Description

arg

Object

Subscribed channel

> instType

String

Product type
UTA Unified trading account

> topic

String

Topic
strategy-order Strategy order

action

String

Push data action
snapshot Full data

String

Push timestamp (milliseconds)

data

List<Object>

Push data

> category

String

Product type
spot Spot
margin Margin
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures

> symbol

String

Symbol name

> orderId

String

Strategy order ID

> clientOid

String

Client strategy order ID

> qty

String

Order quantity

> side

String

Trade side
buy / sell

> posSide

String

Position side
long / short

> reduceOnly

String

Whether it is reduce-only

> type

String

Strategy type
tpsl Take-Profit and Stop-Loss
trigger Trigger Order

> status

String

Strategy order status
pending Waiting to be executed
success Executed
failed Execution failed
cancelled Cancelled
submitting Submitting

> triggerType

String

Trigger type
takeProfit Take-Profit
stopLoss Stop-Loss

> tpTriggerBy

String

Take-Profit trigger price type
market: Market Price
mark: Mark Price

> slTriggerBy

String

Stop-Loss trigger price 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

> createdTime

String

Order created timestamp (Unix milliseconds)

> updatedTime

String

Order update timestamp (Unix milliseconds)