Skip to main content

User Trade Fills

WSProductionwss://ws.btse.com/ws/futuresTestnetwss://testws.btse.io/ws/futures

Notification whenever a trade is executed for the authenticated user. Requires WebSocket authentication. Topic: fillsV2

Response Content​

NameTypeRequiredDescription
topicStringYes
dataObject[]YesArray of data objects

Data Object:

NameTypeRequiredDescription
symbolStringYesMarket symbol
orderIdStringYesInternal order ID
clOrderIdStringYesCustom order ID
serialIdLongYesTrade sequence ID
tradeIdStringYesTrade unique identifier
typeStringYes76: Limit Β· 77: Market Β· 80: Algo
sideStringYesBUY or SELL
priceStringYesTransacted price
sizeStringYesTransacted size
feeAmountStringYesFee amount
feeCurrencyStringYesFee currency
baseStringYesBase currency
quoteStringYesQuote currency
makerBooleanYesWhether maker trade
timestampLongYesTrade timestamp
contractSizeDoubleYesContract size
example

Response

{
"topic": "fillsV2",
"data": [
{
"orderId": "6aa36da1-0ed8-46c1-9327-c9d6313b3d12",
"serialId": 189349157,
"clOrderId": "_W_ekxogc1711427518228",
"type": "77",
"symbol": "BTC-PERP",
"side": "BUY",
"price": "69704.4",
"size": "1.0",
"feeAmount": "0.0348522",
"feeCurrency": "USDT",
"base": "BTC-PERP",
"quote": "USDT",
"maker": false,
"timestamp": 1711427518338,
"contractSize": 0.0001,
"tradeId": "e094117f-9f84-4c82-b55d-d3d2a54d0dca"
}
]
}