User Trade Fills
WSProduction
wss://ws.btse.com/ws/futuresTestnetwss://testws.btse.io/ws/futuresNotification whenever a trade is executed for the authenticated user. Requires WebSocket authentication.
Topic: fillsV2
Response Contentβ
| Name | Type | Required | Description |
|---|---|---|---|
| topic | String | Yes | |
| data | Object[] | Yes | Array of data objects |
Data Object:
| Name | Type | Required | Description |
|---|---|---|---|
| symbol | String | Yes | Market symbol |
| orderId | String | Yes | Internal order ID |
| clOrderId | String | Yes | Custom order ID |
| serialId | Long | Yes | Trade sequence ID |
| tradeId | String | Yes | Trade unique identifier |
| type | String | Yes | 76: Limit Β· 77: Market Β· 80: Algo |
| side | String | Yes | BUY or SELL |
| price | String | Yes | Transacted price |
| size | String | Yes | Transacted size |
| feeAmount | String | Yes | Fee amount |
| feeCurrency | String | Yes | Fee currency |
| base | String | Yes | Base currency |
| quote | String | Yes | Quote currency |
| maker | Boolean | Yes | Whether maker trade |
| timestamp | Long | Yes | Trade timestamp |
| contractSize | Double | Yes | Contract 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"
}
]
}