Skip to main content

User Trade Fills

WSProductionwss://ws.btse.com/ws/spotTestnetwss://testws.btse.io/ws/spot

Notification whenever an order is filled. Requires WebSocket authentication. Topic: fills

Response Content​

NameTypeRequiredDescription
topicStringYes
dataObject[]YesArray of data objects

Data Object:

NameTypeRequiredDescription
symbolStringYesMarket symbol
orderIdStringYesInternal order ID
clOrderIdStringYesCustom order ID
sideStringYesBUY or SELL
priceStringYesFill price
sizeStringYesFill size
feeAmountStringYesFee amount charged
feeCurrencyStringYesFee currency (BUY: base, SELL: quote)
baseStringYesBase currency
quoteStringYesQuote currency
makerBooleanYesWhether this was a maker trade
timestampStringYesFill timestamp
tradeIdStringYesUnique 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>"
}
]
}