Skip to main content

Query User Trades Fills

Returns the authenticated user's trade history.

Time range constraints:

  • startTime + endTime: max 7 days
  • startTime only: 7 days after start
  • endTime only: 7 days before end
  • Neither: 7 days before current time

Request Parameters​

NameTypeRequiredDescription
symbolStringNoMarket symbol. Optional β€” if omitted, returns trades across all symbols.
startTimeLongNoStarting time in milliseconds
endTimeLongNoEnding time in milliseconds
countIntegerNoNumber of records to return
clOrderIDStringNoFilter by custom order ID
orderIDStringNoFilter by order ID
isMatchSymbolBooleanNoIf true, exact match on symbol only

Response Content​

NameTypeDescription
symbolStringMarket symbol
sideStringBUY or SELL
priceDoubleFill price
sizeDoubleFill size
serialIdLongSerial ID
timestampLongFill timestamp
orderIdStringOrder ID
clOrderIdStringCustom order ID
feeAmountDoubleFee charged
feeCurrencyStringFee currency
example
GEThttps://api.btse.com/spot/api/v3.3/user/trade_history

Response

[]