Skip to main content

Fill Channel

Get the order fill (trade execution) data

Request Parameters

ParameterTypeRequiredDescription
opstringYesOperation, subscribe unsubscribe
argslistYesList of channels to request subscription
> instTypestringYesProduct type: SPOT
> channelstringYesChannel name: fill
> instIdstringNoProduct ID (optional, e.g. BTCUSDT)

Request Example

{
"op": "subscribe",
"args": [
{
"instType": "SPOT",
"channel": "fill",
"instId": "default"
}
]
}

Response Example

{
"event": "subscribe",
"arg": {
"instType": "SPOT",
"channel": "fill",
"instId": "default"
}
}

Push Parameters

ParameterTypeDescription
actionstringPush data action: snapshot / update
argobjectChannels with successful subscription
> instTypestringProduct type: SPOT
> channelstringChannel name: fill
> instIdstringProduct ID
datalistFill data list
> orderIdstringOrder ID
> tradeIdstringTrade ID
> symbolstringSymbol (e.g. BTCUSDT)
> orderTypestringOrder type: limit / market
> sidestringTrade side: buy / sell
> priceAvgstringFilled price
> sizestringFilled size
> amountstringFilled amount (price * size)
> tradeScopestringTrade scope: maker / taker
> feeDetaillistFee details
> cTimestringCreate time
> uTimestringUpdate time
tsnumberPush timestamp

Push Data

{
"action": "snapshot",
"arg": {
"instType": "SPOT",
"channel": "fill",
"instId": "default"
},
"data": [
{
"orderId": "123456789",
"tradeId": "987654321",
"symbol": "BTCUSDT",
"orderType": "limit",
"side": "buy",
"priceAvg": "27000.0",
"size": "0.05",
"amount": "1350.00000000",
"tradeScope": "taker",
"feeDetail": [
{
"feeCoin": "USDT",
"fee": "1.35"
}
],
"cTime": "1695716760565",
"uTime": "1695716760565"
}
],
"ts": 1695716761589
}