Fill Channel

Subscribes to fill details. Data is pushed in real time when an order is filled.

Channel name: fill

The fill channel provides execution-level updates for authenticated users. It includes order identifiers, trade identifiers, execution price and size, trade scope, fee details, and timestamps.


Subscription Request

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

Push Data Format

{
  "action": "snapshot",
  "arg": {
    "instType": "SPOT",
    "channel": "fill",
    "instId": "default"
  },
  "data": [
    {
      "clientOid": "osl-global-eth-usdtXMRX3ea35dac9002054",
      "timeInForce": "gtc",
      "orderId": "1410149151286538240",
      "tradeId": "1410149151492153345",
      "symbol": "ETHUSDT",
      "side": "sell",
      "orderType": "limit",
      "priceAvg": "1000.00",
      "size": "0.01000000",
      "amount": "10.000000",
      "tradeScope": "taker",
      "feeDetail": [
        {
          "feeCoin": "USDT",
          "fee": "-0.02000"
        }
      ],
      "cTime": "1771931677697",
      "uTime": "1771931677697"
    }
  ]
}

Field Descriptions

FieldTypeDescription
orderIdStringOrder ID
tradeIdLongTrade ID
symbolStringTrading pair, such as BTCUSDT
sideStringBuy/sell direction: buy/sell
orderTypeStringOrder type: limit/market
priceAvgStringExecution price
sizeStringExecuted quantity, base coin
amountStringExecuted amount, quote coin
tradeScopeStringLiquidity direction: taker/maker
feeDetail[].feeCoinStringFee currency
feeDetail[].feeStringFee amount
cTimeStringCreation timestamp, in milliseconds
uTimeStringUpdate timestamp, in milliseconds