Skip to main content

Trade

Description

When a trade is executed, the following information will be pushed.

Pushing Frequency

Real Time

Channel

trade

Request Parameters

ParameterRequiredTypeDescription
eventYesStringOperation: subscribe, unsubscribe
channelYesArraytrade
symbolsYesArraytrading pair array

Request Response

ParameterTypeDescription
eventStringOperation: subscribe, unsubscribe
channelStringtrade
symbolsArraytrading pair array
messageStringError message

Push Data

ParameterTypeDescription
channelStringtrade
dataArrayThe subscribed data
> symbolStringA trading pair
> sideStringEnumerate: BUY, SELL
> ordIdStringOrder ID
> clOrdIdStringClient Order ID as assigned by the client
> roleStringExecution Role: MAKER, TAKER
> trdIdStringTransaction ID
> feeCcyStringName of the currency used for trading fees
> feeAmtStringCumulative amount of trading fee
> deductCcyStringName of the currency used to deduct trading fees
> deductAmtStringCumulative amount of trading fee deducted
> fpxStringprice
> fqtyStringsize
> uTimeStringTrade update time with a UTC timestamp (millisecond)
> tsLongPush time (millisecond)

Request Example

{
"event": "subscribe",
"channel": ["trade"],
"symbols": ["BTC_USDT_PERP"]
}

Push Data Example

{
"channel": "trade",
"data": [
{
"symbol": "BTC_USDT_PERP",
"side": "BUY",
"ordId": "353849510130364416",
"clOrdId": "polo353849510130364416",
"role": "TAKER",
"trdId": "48",
"feeCcy": "USDT",
"feeAmt": "0.259996",
"deductCcy": "",
"deductAmt": "0",
"fpx": "64999",
"fqty": "1",
"uTime": 1725330697559
}
]
}