Skip to main content

Query 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
startTimeLongNoStart time in milliseconds
endTimeLongNoEnd time in milliseconds
beforeSerialIdLongNoPagination for high-volume markets
afterSerialIdLongNoPagination for high-volume markets
countLongNoNumber of records
includeOldBooleanNoInclude records older than 7 days
orderIDStringNoFilter by order ID
clOrderIDStringNoFilter by custom order ID

Response Content​

NameTypeDescription
symbolStringMarket symbol
sideStringTrade side β€” BUY Β· SELL
priceDoubleTransacted price
sizeLongOriginal order size
serialIdLongRunning sequence ID
tradeIdStringTrade identifier
orderIdStringOrder ID
clOrderIDStringCustom order ID
timestampLongTrade timestamp
baseStringBase currency
quoteStringQuote currency
walletStringCROSS@ or ISOLATED@{symbol}-USDT
feeCurrencyStringFee currency
feeAmountDoubleFee amount
filledPriceDoubleFilled price
avgFilledPriceDoubleAverage filled price
filledSizeLongFilled size
orderTypeIntegerOrder type
realizedPnLDoubleRealized P&L
positionIdStringPosition ID
contractSizeDoubleContract size
example
GEThttps://api.btse.com/futures/api/v2.3/user/trade_history

Response

[]