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: USDT-FUTURES
> channelstringYesChannel name: fill
> instIdstringNoProduct ID (optional)

Request Example

{
"op": "subscribe",
"args": [
{
"instType": "USDT-FUTURES",
"channel": "fill",
"instId": "default"
}
]
}

Response Example

{
"event": "subscribe",
"arg": {
"instType": "USDT-FUTURES",
"channel": "fill",
"instId": "default"
}
}

Push Parameters

ParameterTypeDescription
actionstringPush data action
argobjectChannels with successful subscription
> instTypestringProduct type
> channelstringChannel name
> instIdstringProduct ID
datalistFill data list
> symbolstringSymbol
> tradeIdstringTrade ID
> orderIdstringOrder ID
> tradeTypestringTrade type
> sidestringTrade side
> feestringFee
> pricestringFilled price
> amountstringFilled amount
> profitstringProfit
> cTimenumberCreate time
tsnumberPush timestamp

Push Data

{
"action": "snapshot",
"arg": {
"instType": "USDT-FUTURES",
"channel": "fill",
"instId": "default"
},
"data": [
{
"symbol": "BTCUSDT",
"tradeId": "987654321",
"orderId": "123456789",
"tradeType": "LIMIT OPEN",
"side": "LONG",
"fee": "2.70",
"price": "27000.0",
"amount": "0.1",
"profit": "0",
"cTime": 1695716760565
}
],
"ts": 1695716761589
}