跳到主要内容

订单

描述

订阅订单频道

以下事件发生时推送数据:

  1. 首次订阅,不推送
  2. 统一账户现货/杠杆/合约委托单下单,推送
  3. 统一账户现货/杠杆/合约委托单成交,推送
  4. 统一账户现货/杠杆/合约委托单撤单,推送
请求示例
{
"op": "subscribe",
"args": [
{
"instType": "UTA",
"topic": "order"
}
]
}

请求参数

参数名参数类型是否必须描述
opString操作:
subscribe 订阅
unsubscribe 取消订阅
argsList<Object>请求订阅的频道列表
> instTypeString产品类型
UTA 统一账户
> topicString频道名: order 订单
订阅返回示例
{
"event": "subscribe",
"arg": {
"instType": "UTA",
"topic": "order"
}
}

返回参数说明

返回字段参数类型字段说明
eventString操作
subscribe 订阅
unsubscribe 退订
error 参数错误
argObject订阅的频道
> instTypeString产品类型
UTA 统一账户
> topicString频道名
order 订单频道
codeString错误码
msgString错误消息
推送返回示例
{
"action": "snapshot",
"arg": {
"instType": "UTA",
"topic": "order"
},
"data": [
{
"category": "usdt-futures",
"symbol": "BTCUSDT",
"orderId": "xxx",
"clientOid": "xxx",
"price": "",
"qty": "0.001",
"amount": "1000",
"holdMode": "hedge_mode",
"holdSide": "long",
"delegateType": "normal",
"tradeSide": "open",
"orderType": "market",
"timeInForce": "gtc",
"side": "buy",
"marginMode": "crossed",
"marginCoin": "USDT",
"reduceOnly": "no",
"cumExecQty": "0.001",
"cumExecValue": "83.1315",
"avgPrice": "83131.5",
"totalProfit": "0",
"orderStatus": "filled",
"cancelReason": "",
"leverage": "20",
"feeDetail": [
{
"feeCoin": "USDT",
"fee": "0.0332526"
}
],
"createdTime": "1742367838101",
"updatedTime": "1742367838115",
"stpMode": "none"
}
],
"ts": 1742367838124
}

推送参数说明

返回字段参数类型字段说明
argObject订阅成功频道
> instTypeString产品线类型
UTA统一账户
> topicString频道名
order订单频道
actionString推送数据动作
snapshot全量
dataList<Object>订阅的数据
> categoryString业务线
SPOT现货交易
MARGIN 杠杆交易
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约
> symbolString交易对名称
> orderIdString订单ID
> clientOidString自定义订单ID
> priceString委托价格
> qtyString委托数量
> amountString委托金额
> holdModeString持仓模式
one_way_mode: 单向持仓
hedge_mode: 双向持仓
> tradeSideString交易方向
open: 开
close : 平
详细枚举可以在 枚举 页面获取
> orderTypeString订单类型
limit : 限价
market : 市价
> timeInForceString订单执行策略
ioc: 无法立即成交的部分就撤销
fok: 无法全部立即成交就撤销
gtc: 普通订单, 订单会一直有效,直到被成交或者取消
post_only: 只做maker
> sideString订单方向
buy: 买
sell: 卖
> holdSideString持仓方向
long: 双向持仓多头
short: 双向持仓空头
net: 单向持仓
> delegateTypeString委托类型
normal: 限价普通
stop_profit_market: 最优价止盈
stop_loss_market: 最优价止损
stop_profit_chase: 止盈追价委托
stop_loss_chase: 止损追价委托
trader_delegate: 带单委托
trader_stop_profit: 带单止盈
trader_stop_loss: 带单止损
follower_delegate: 跟单委托
reduce_offset_delegate: 减仓扎差委托
market: 最优价普通
market_risk: 最优价风险处理
plan_limit: 限价计划委托
plan_market: 最优价计划委托
back_contract: 反手
trader_back_contract: 带单反手
strategy_grid_positive: 策略-正向网格
strategy_grid_reverse: 策略-反向网格
strategy_unlimited: 无限策略
stop_profit_limit: 限价止盈
stop_loss_limit: 限价止损
move_stop_limit: 限价移动止盈止损
move_stop_market: 最优价移动止盈止损
position_stop_profit_limit: 限价仓位止盈
position_stop_profit_market: 最优价仓位止盈
position_stop_loss_limit: 限价仓位止损
position_stop_loss_market: 最优价仓位止损
tracking_plan_limit: 限价追踪委托
tracking_plan_market: 最优价追踪委托
delivery_close_long: 多头交割
delivery_close_short: 空头交割
liquidation: 爆仓清算
strategy_dca_positive: DCA策略-正向
strategy_dca_reverse: DCA策略-反向
spot_trace_trader_buy: 现货带单买
spot_trace_follower_buy: 现货跟单买
spot_trace_trader_sell: 现货带单卖
spot_trace_follower_sell: 现货跟单卖
strategy_oco_limit: 策略-OCO限价单
strategy_oco_trigger: 策略-OCO触发单
modify_limit_order: 限价修改
strategy_regular_buy: 策略-定投策略买
strategy_grid_middle: 策略-中性网格
strategy_cta_positive: CTA策略-正向
strategy_cta_reverse: CTA策略-反向
strategy_tpsl_limit: 现货止盈止损限价单
strategy_tpsl_market: 现货止盈止损市价单
strategy_contract_ai: 合约AI智投
strategy_trace_market: 追踪委托市价单
strategy_trace_limit: 追踪委托限价单
strategy_portfolio_buy: 策略-囤币宝买
strategy_portfolio_sell: 策略-囤币宝卖
strategy_tradingview: TRADINGVIEW信号接入策略
sigan_trace: 信号跟单
mmr_stop_loss_market: 最优价MMR止损
bbo_opponent1: BBO-对手价1
bbo_opponent5: BBO-对手价5
bbo_companion1: BBO-同向价1
bbo_companion5: BBO-同向价5
bbo_opponent1_profit: BBO-对手价1止盈
bbo_opponent5_profit: BBO-对手价5止盈
bbo_companion1_profit: BBO-同向价1止盈
bbo_companion5_profit: BBO-同向价5止盈
bbo_opponent1_loss: BBO-对手价1止损
bbo_opponent5_loss: BBO-对手价5止损
bbo_companion1_loss: BBO-同向价1止损
bbo_companion5_loss: BBO-同向价5止损
spot_bbo_opponent1_tpsl: BBO-对手价1止盈止损
spot_bbo_opponent5_tpsl: BBO-对手价5止盈止损
spot_bbo_companion1_tpsl: BBO-同向价1止盈止损
spot_bbo_companion5_tpsl: BBO-同向价5止盈止损
dummy_bbo_profit: BBO-止盈
dummy_bbo_loss: BBO-止损
strategy_pre_tpsl_limit: 现货预设止盈止损限价单
strategy_pre_tpsl_market: 现货预设止盈止损市价单
future_signal_delegate: 合约喊单跟单限价单
grant_market: 体验券开仓
tg_signal_limit: TG信号单
tg_signal_tp_market: TG信号单止盈
tg_signal_sl_market: TG信号单止损
strategy_preset_tpsl_limit: 现货预设计划委托止盈止损限价单
strategy_preset_tpsl_market: 现货预设计划委托止盈止损市价单
trader_iceberg_limit: 冰山委托
trader_time_share_market: 分时委托
strategy_arbitrage_positive: 资金费套利策略正向
strategy_arbitrage_reverse: 资金费套利策略反向
liquidation_take_over_long: 爆仓接管多仓
liquidation_take_over_short: 爆仓接管空仓
convert_hedging: 闪兑操盘
off_close: 下架平仓
> marginModeString保证金模式
crossed: 全仓模式
isolated: 逐仓模式
> reduceOnlyString是否只减仓
yes: 是 no : 否
> marginCoinString保证金币种
> cumExecQtyString累计成交数量
> cumExecValueString累计成交金额
> avgPriceString平均成交价 若未成交,该字段也为0
> totalProfitString订单总盈亏
> orderStatusString订单状态
live: 订单已创建
new: 订单已进入撮合
partially_filled: 部分成交
filled: 全部成交
cancelled: 已撤销
> cancelReasonString订单取消原因
详细枚举可以在 枚举 页面获取
> leverageString杠杆倍数
> feeDetailList手续费详情列表
>> feeCoinString手续费币种
>> feeString手续费数量
> createdTimeString订单创建时间
Unix时间戳的毫秒数格式,如 1597026383085
> updatedTimeString订单更新时间
Unix时间戳的毫秒数格式,如 1597026383085
> stpModeStringSTP(自成交预防)模式
none:无STP设置
cancel_taker:取消taker单
cancel_maker:取消maker单
cancel_both:两者都取消

您的阅读体验如何?