Get private trades history [Private]

get https://{BASE_URL_PROD}/v4/trade/private/history

Get a list of trades by pair (e.g. BTC_USDT).
Returns an array of your trades with details on each trade, 10 trades maximum, newest first.

This is a private route, so the api-key parameter should be sent in the header.

Data dictionary

Name	Type	Parameter type	Required	Range	Description
pair	string	QUERY	NO	-	A trading pair as per the list from /v4/markets/public/getAll
orderId	string	QUERY	NO	-	UUID of an order, to receive trades for this order only

📘️ If pair and orderId were not specified, returns the latest 10 trades for any trade pair and any order.

Exemplary request

To properly test this endpoint, you need to have trades under your account.
The easiest way is to create 2 alike order of different order side (Ask/Bid) and let them close each other.
Once done, please use this endpoint: {{baseURL}}/v4/trade/private/history

Response structure

You will receive a JSON in the response with data object, containing an array of Trades objects that fulfill the criteria, structured like this example:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "id": "edb17459-c9bf-4148-9ae6-7367d7f55d71",       // Unique identifier of a trade 
    "orderId": "a80bec3f-4ffa-45c1-9d78-f6301e9748fe",  // Unique identifier of an order associated with the trade
    "pair": "BTC_USDT",                                 // Traded pair, base asset first, followed by quoted asset
    "quantity": "1.5862",                               // Traded quantity of base asset
    "price": "19087",                                   // Price of the trade
    "isTaker": true,                                    // Various fees for Makers and Takers; "Market" orders are always `true`
    "fee": "0.0039655",                                 // Exchange commission fee
    "feeCurrency": "BTC",                               // Currency of the commission
    "isBuyer": true,                                    // Buy or sell the base asset
    "quoteQuantity": "30275.7994",                      // Quote asset quantity spent to fulfill the base amount
    "createdAt": "2022-09-29T13:43:53.824Z"             // Date-time of trade execution, UTC
}

Errors

Status	Error code	Message	Parameter	Description
400	WrongRequestException	orderId must be a UUID	`orderId`	The order id should match UUID pattern, for example, `c7fc5b2b-bd9d-48c1-a458-a83412669cf4`