Fill Channel

Description

Trade details channel

Data will be pushed when order filled.

Request Example

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

Request Parameters

Parameter	Type	Required	Description
op	String	Yes	Operation, subscribe unsubscribe
args	List<Object>	Yes	List of channels to request subscription
> channel	String	Yes	Channel name: fill
> instType	String	Yes	Product 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
> instId	String	No	Product ID or default， delivery contract reference：https://www.cointr.com/api-doc/common/release-note#optimization-of-delivery-futures

Response Example

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

Response Parameters

Parameter	Type	Description
event	String	Event
arg	Object	Subscribed channels
> channel	String	Channel name: fill
> instType	String	Product 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
> instId	String	Product ID or default delivery contract reference：https://www.cointr.com/api-doc/common/release-note#optimization-of-delivery-futures
code	String	Error code
msg	String	Error message

Push Data

{
    "action":"snapshot",
    "arg":{
        "instType":"USDT-FUTURES",
        "channel":"fill",
        "instId":"default"
    },
    "data":[
        {
            "orderId":"111",
            "tradeId":"222",
            "symbol":"BTCUSDT",
            "side":"buy",
            "orderType":"market",
            "posMode":"one_way_mode",
            "price":"51000.5",
            "baseVolume":"0.01",
            "quoteVolume":"510.005",
            "profit":"0",
            "tradeSide":"open",
            "tradeScope":"taker",
            "feeDetail":[
                {
                    "feeCoin":"USDT",
                    "deduction":"no",
                    "totalDeductionFee":"0",
                    "totalFee":"-0.183717"
                }
            ],
            "cTime":"1703577336606",
            "uTime":"1703577336606"
        }
    ],
    "ts":1703577336700
}

推送数据参数

返回字段	参数类型	字段说明
action	String	snapshot
arg	Object	Channels with successful subscription
> channel	String	Channel name: fill
> instType	String	Product 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
> instId	String	Product ID or default delivery contract reference：https://www.cointr.com/api-doc/common/release-note#optimization-of-delivery-futures
data	List<Object>	Subscription data
> orderId	String	Order ID
> tradeId	String	Trade ID
> symbol	String	Symbol
> side	String	Order direction buy sell
> orderType	String	Order type limit limit order market market order
> posMode	String	Hold Mode one_way_mode hedge_mode
> price	String	Order price
> baseVolume	String	Number of base coin
> quoteVolume	String	Number of denomination coin
> profit	String	Realized PnL
> tradeSide	String	Trade Side trading direction open close buy_single sell_single reduce_close_long reduce_close_short offset_close_long offset_close_short burst_close_long burst_close_short delivery_close_long delivery_close_short
> tradeScope	String	The liquidity direction of the latest transaction taker maker
> feeDetail	List<Object>	Transaction fee of the order
>> deduction	String	deduction yes no
>> totalDeductionFee	String	Fee of deduction
>> totalFee	String	Fee of all
>> feeCoin	String	Currency of transaction fee
> cTime	String	Create Time，milliseconds format of Unix timestamp, e.g.1597026383085
> uTime	String	Update Time，milliseconds format of Unix timestamp, e.g.1597026383085