User Trade Fills
WSProduction
wss://ws.btse.com/ws/spotTestnetwss://testws.btse.io/ws/spotNotification whenever an order is filled. Requires WebSocket authentication.
Topic: fills
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 |
| side | String | Yes | BUY or SELL |
| price | String | Yes | Fill price |
| size | String | Yes | Fill size |
| feeAmount | String | Yes | Fee amount charged |
| feeCurrency | String | Yes | Fee currency (BUY: base, SELL: quote) |
| base | String | Yes | Base currency |
| quote | String | Yes | Quote currency |
| maker | Boolean | Yes | Whether this was a maker trade |
| timestamp | String | Yes | Fill timestamp |
| tradeId | String | Yes | Unique trade ID |
example
Response
{
"topic": "fills",
"data": [
{
"orderId": "<order ID>",
"serialId": "<serial ID>",
"clOrderId": "<custom order ID>",
"type": "<order type>",
"symbol": "BTC-USD",
"side": "BUY",
"price": "34000.0",
"size": "1.0",
"feeAmount": "0.01",
"feeCurrency": "USD",
"base": "BTC",
"quote": "USD",
"maker": false,
"timestamp": "1624985375123",
"tradeId": "<trade unique ID>"
}
]
}