Skip to main content

Isolated-Margin Orders Channel

Description

Request Example

{
"args":[
{
"channel":"orders-isolated",
"instId":"BTCUSDT",
"instType":"MARGIN"
}
],
"op":"subscribe"
}

Request Parameters

ParameterTypeRequiredDescription
opStringYesOperation
subscribe Subscribe
unsubscribe Unsubscribe
argsList<Object>YesList of channels to request subscription
> instTypeStringYesProduct type
USDT-FUTURES USDT professional futures
COIN-FUTURES Mixed futures
USDC-FUTURES USDC professional futures
SUSDT-FUTURES USDT professional futures demo
SCOIN-FUTURES Mixed futures demo
SUSDC-FUTURES USDC professional futures demo
> channelStringYesChannel name
> instIdStringYesProduct ID
E.g. ETHUSDT
Response Example
{
"event":"subscribe",
"arg":{
"instType":"MARGIN",
"channel":"orders-isolated",
"instId":"BTCUSDT"
}
}

Response Parameters

ParameterTypeDescription
eventStringYes
Event
argObjectSubscribed channels
> instTypeStringProduct type
USDT-FUTURES USDT professional futures
COIN-FUTURES Mixed futures
USDC-FUTURES USDC professional futures
SUSDT-FUTURES USDT professional futures demo
SCOIN-FUTURES Mixed futures demo
SUSDC-FUTURES USDC professional futures demo
> channelStringChannel name
> instIdStringProduct ID
E.g. ETHUSDT
codeStringError code, returned only on error
msgStringError message
Push Data
{
"action":"snapshot",
"arg":{
"instType":"MARGIN",
"channel":"orders-isolated",
"instId":"BTCUSDT"
},
"data":[
{
"enterPointSource":"web",
"force":"gtc",
"orderType":"market",
"price":"0.000000000",
"quoteSize":"0.000000000",
"side":"sell",
"feeDetail":[
{
"feeCoin":"USDT",
"deduction":"no",
"totalDeductionFee":"0",
"totalFee":"0.01538693"
}
],
"status":"partially_filled",
"baseSize":"0.056100000",
"cTime":"1697094058377",
"clientOid":"1",
"fillPrice":"26869.6530837789661319",
"baseVolume":"0.056100000",
"fillTotalAmount":"1507.387538000",
"loanType":"auto-repay",
"orderId":"1",
"stpMode":"cancel_taker"
}
],
"ts":1697094058809
}

Push Data Parameters

ParameterTypeDescription
argObjectSuccessful channel subscriptions
> instTypeStringProduct type
USDT-FUTURES USDT professional futures
COIN-FUTURES Mixed futures
USDC-FUTURES USDC professional futures
SUSDT-FUTURES USDT professional futures demo
SCOIN-FUTURES Mixed futures demo
SUSDC-FUTURES USDC professional futures demo
> channelStringChannel name
> instIdStringProduct ID e.g. ETHUSDT
actionStringPush data action, snapshot or update
dataList<Object>Subscribed data
> baseSizeStringNumber of base coins
> cTimeStringTime of order
> clientOidStringClient Unique Identifier
> fillPriceStringSale price
> baseVolumeStringFilled quantity
> fillTotalAmountStringsum of money sold
> loanTypeStringMargin order model
normal: place a normal order
autoLoan place an order with auto-borrow
autoRepay place an order with auto-repay
autoLoanAndRepay place an order with auto-borrow and auto-repay
> orderIdStringOrder ID
> orderTypeStringOrder type
limit: limit price
market: market price
> priceStringOrder price
> quoteSizeStringNumber of denominated coins
> sideStringMethods of Sale and Purchase
> feeDetailList<Object>Transaction fee of the order
  >> deductionStringIs discount
  >> totalDeductionFeeStringFee of discount
  >> totalFeeStringOrder transaction fee, the transaction fee charged by the platform from the user.
  >> feeCoinStringThe currency of the transaction fee
> enterPointSourceStringOrder source
WEB: Orders created on the website
API: Orders created on API
SYS: System managed orders, usually generated by forced liquidation logic
ANDROID: Orders created on the Android app
IOS: Orders created on the iOS app
> statusStringOrder status
> symbolStringTrading pair
> forceStringOrder Strategy
> stpModeStringSTP Mode
none not setting STP
cancel_taker cancel taker order
cancel_maker cancel maker order
cancel_both cancel both of taker and maker orders
tsLongTimestamp ms

How was your Reading Experience with us?