Получение истории сделок

Endpoint

POST /orders/trades

Описание

Получение истории сделок с фильтрацией, сортировкой и пагинацией.

Заголовки

• Обязательные заголовки аутентификации

Тело запроса

{
"filters": {
  "orderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "pairs": [
    {
      "currencyFrom": "KGS",
      "currencyTo": "USDT"
    }
  ],
  "createdAt": {
    "start": "2024-01-01T00:00:00Z",
    "end": "2024-01-15T23:59:59Z"
  },
  "executedAt": {
    "start": "2024-01-01T00:00:00Z",
    "end": "2024-01-15T23:59:59Z"
  },
  "orderType": ["LIMIT", "MARKET"],
  "orderDirection": "BUY"
},
"sorts": {
  "order": "DESC",
  "sort": "CREATION_DATE"
},
"pagination": {
  "size": 10,
  "page": 0
}
}

Параметры запроса:

Параметр	Тип	Обязательный	Описание	Пример
filters	object	❌	Фильтры для поиска сделок
filters.orderId	string	❌	UUID ордера	"3fa85f64-5717-4562-b3fc-2c963f66afa6"
filters.pairs	array	❌	Список торговых пар
filters.pairs[].currencyFrom	string	✅	Базовая валюта	"BTC"
filters.pairs[].currencyTo	string	✅	Котируемая валюта	"USDT"
filters.createdAt	object	❌	Фильтр по времени создания
filters.createdAt.start	string	❌	Начальная дата	"2024-01-01T00:00:00Z"
filters.createdAt.end	string	❌	Конечная дата	"2024-01-15T23:59:59Z"
filters.executedAt	object	❌	Фильтр по времени исполнения
filters.executedAt.start	string	❌	Начальная дата	"2024-01-01T00:00:00Z"
filters.executedAt.end	string	❌	Конечная дата	"2024-01-15T23:59:59Z"
filters.orderType	array	❌	Типы ордеров	["LIMIT", "MARKET"]
filters.orderDirection	string	❌	Направление ордера	"BUY"
sorts	object	✅	Настройки сортировки
sorts.order	string	✅	Порядок: ASC, DESC	"DESC"
sorts.sort	string	✅	Поле сортировки	"CREATION_DATE"
pagination	object	✅	Настройки пагинации
pagination.size	integer	✅	Размер страницы	10
pagination.page	integer	✅	Номер страницы	0

Доступные значения для сортировки

sorts.order:

Значение	Описание
ASC	По возрастанию
DESC	По убыванию

sorts.sort:

Значение	Описание
CREATION_DATE	По дате создания
EXECUTION_DATE	По дате исполнения
CURRENCY_FROM	По базовой валюте
CURRENCY_TO	По котируемой валюте
ORDER_TYPE	По типу ордера
ORDER_DIRECTION	По направлению ордера

Пример запроса

{
"filters": {
  "orderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "pairs": [
    {
      "currencyFrom": "KGS",
      "currencyTo": "USDT"
    }
  ],
  "createdAt": {
    "start": "2024-01-01T00:00:00Z",
    "end": "2024-01-15T23:59:59Z"
  }
},
"sorts": {
  "order": "DESC",
  "sort": "CREATION_DATE"
},
"pagination": {
  "size": 10,
  "page": 0
}
}

Response

{
"list": [
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "currencyFrom": "KGS",
    "currencyTo": "USDT",
    "orderType": "LIMIT",
    "orderDirection": "BUY",
    "price": "92500.00",
    "amount": "1.2",
    "volume": "111000.00",
    "createdAt": "2024-01-15T10:31:00Z",
    "executedAt": "2024-01-15T10:31:05Z",
    "commission": "22.20",
    "commissionType": "TAKER",
    "commissionPercent": "0.002",
    "orderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
],
"total": 1
}

Параметры Response:

Параметр	Тип	Описание
list	array	Список сделок
total	integer	Общее количество сделок

Объект Trade:

Параметр	Тип	Описание
id	string	UUID сделки
currencyFrom	string	Базовая валюта
currencyTo	string	Котируемая валюта
orderType	string	Тип ордера: LIMIT, MARKET
orderDirection	string	Направление: BUY, SELL
price	string	Цена сделки
amount	string	Количество базовой валюты
volume	string	Объем сделки в котируемой валюте
createdAt	string	Время создания сделки
executedAt	string	Время исполнения сделки
commission	string	Сумма комиссии
commissionType	string	Тип комиссии: MAKER, TAKER
commissionPercent	string	Процент комиссии
orderId	string	UUID родительского ордера

Error response

{
"success": true,
"timestamp": "2025-11-26T08:57:15.631Z", 
"requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"error": {
  "code": "string"
}
}