Get private trades history [Private]

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

NameTypeParameter typeRequiredRangeDescription
pairstringQUERYNO-A trading pair as per the list from /v4/markets/public/getAll
orderIdstringQUERYNO-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

StatusError codeMessageParameterDescription
400WrongRequestExceptionorderId must be a UUIDorderIdThe order id should match UUID pattern, for example, c7fc5b2b-bd9d-48c1-a458-a83412669cf4
Language
Authorization
Header
URL
Click Try It! to start a request and see the response here!