Trade history

GET🔒 Read

⚡ Query: 15 req/s per endpoint · 30 req/s per user

tip

Try It Out — test this endpoint in the API Explorer

Return the caller's recent trade executions for a trading pair, optionally filtered by time range, count, order ID, or client order ID.

Request Parameters

Name	Type	Required	Description
symbol	String	Yes	Trading pair
startTime	Long	No	Only include trades at or after this Unix timestamp in milliseconds
endTime	Long	No	Only include trades at or before this Unix timestamp in milliseconds
count	Integer	No	Maximum number of trades to return, defaults to 10
clOrderId	String	No	Client-supplied order ID to filter by
orderId	String	No	Order ID to filter by
isMatchSymbol	Boolean	No	If true, match trades by base/quote currency rather than the exact symbol string, to also cover alias symbols for the same pair

Response Content

Name	Type	Description
serialId	Long	Monotonic sequence identifier for this trade record.
tradeId	String	Unique trade identifier.
orderId	String	Identifier of the order this trade was executed against.
clOrderId	String	Client-supplied order identifier of the originating order.
symbol	String	Trading pair, formatted as BASE-QUOTE (e.g. BTC-USDT).
base	String	Base currency of the trading pair.
quote	String	Quote currency of the trading pair.
orderSide	String	Order side: BUY or SELL.
orderType	Integer	Numeric order-type code of the originating order (limit, market, peg, TWAP).
triggerType	Integer	Numeric trigger order-type code (stop-loss, take-profit, stop-loss-limit, or take-profit-limit). Only meaningful when the originating order was a trigger order.
triggerPrice	Double	Trigger price of the originating order. Only meaningful when the originating order was a trigger order.
price	Double	Execution price of this trade.
size	Double	Original order size of the originating order.
filledSize	Double	Amount filled by this trade, in base currency.
feeCurrency	String	Currency in which the trading fee was charged.
feeAmount	Double	Trading fee amount charged for this trade, in feeCurrency.
timestamp	Long	Trade execution timestamp in Unix epoch milliseconds.

example

GEThttps://api.btse.com/spot/api/v4/trade/trade_history

Response (default)

[
  {
    "serialId": 375599088,
    "tradeId": "de1a79b8-f408-4e05-b8b7-7ed3c4e86542",
    "orderId": "6c72d906-cb8f-469c-8ab0-b97bc8dff9c2",
    "clOrderId": null,
    "symbol": "BTC-USD",
    "base": "BTC",
    "quote": "USD",
    "orderSide": "BUY",
    "orderType": 77,
    "triggerType": 0,
    "triggerPrice": 0,
    "price": 64235.97008,
    "size": 1.9,
    "filledSize": 0.00002,
    "feeCurrency": "BTC",
    "feeAmount": 1e-8,
    "timestamp": 1784890959551
  },
  {
    "serialId": 375599086,
    "tradeId": "7ed825de-1903-4020-b74f-e04cdce835b9",
    "orderId": "1ec3cc46-928a-4cbe-8683-852bc5de7f9f",
    "clOrderId": null,
    "symbol": "BTC-USD",
    "base": "BTC",
    "quote": "USD",
    "orderSide": "BUY",
    "orderType": 77,
    "triggerType": 0,
    "triggerPrice": 0,
    "price": 64234.684332,
    "size": 1.9,
    "filledSize": 0.00002,
    "feeCurrency": "BTC",
    "feeAmount": 1e-8,
    "timestamp": 1784890649859
  },
  {
    "serialId": 375599084,
    "tradeId": "68ec4220-4e9b-4d7a-a0c6-560b46f7605a",
    "orderId": "ca099453-6553-4eae-b696-26f59c50c3b2",
    "clOrderId": null,
    "symbol": "BTC-USD",
    "base": "BTC",
    "quote": "USD",
    "orderSide": "BUY",
    "orderType": 77,
    "triggerType": 0,
    "triggerPrice": 0,
    "price": 64234.684332,
    "size": 1.9,
    "filledSize": 0.00002,
    "feeCurrency": "BTC",
    "feeAmount": 1e-8,
    "timestamp": 1784890619788
  }
]