История ордеров

Endpoint

POST /orders

Описание

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

Заголовки

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

---

Тело запроса

Параметры

Параметр	Тип	Обязательный	Описание
filters	Object	❌	Фильтры для поиска ордеров
sorts	Object	✅	Параметры сортировки
pagination	Object	✅	Пагинация

---

Структура фильтров

Параметр	Тип	Описание
orderId	string	UUID ордера
pairs	array	Массив торговых пар
createdAt	object	Диапазон дат создания
executedAt	object	Диапазон дат исполнения
orderType	array	Типы ордеров
orderDirection	string	Направление ордера
status	array	Статусы ордеров

---

Структура сортировки

Параметр	Тип	Значение по умолчанию	Допустимые значения
order	string	DESC	ASC, DESC
sort	string	CREATION_DATE	CREATION_DATE, EXECUTION_DATE, CURRENCY_FROM, CURRENCY_TO, ORDER_TYPE, ORDER_DIRECTION, STATUS

---

Пагинация

Параметр	Тип	Значение по умолчанию	Описание
size	integer	10	Количество элементов на странице
page	integer	0	Номер страницы

---

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

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

---

Response

{
"list": [
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "currencyFrom": "BTC",
    "currencyTo": "USDT",
    "orderType": "LIMIT",
    "orderDirection": "BUY",
    "avgExecutedPrice": "92500.00",
    "price": "92783.70",
    "executedAmount": "1.2",
    "amount": "1.2",
    "volume": "111340.44",
    "executedVolume": "111000.00",
    "createdAt": "2024-01-15T10:30:00Z",
    "executedAt": "2024-01-15T10:31:00Z",
    "commission": "22.20",
    "incomeAmount": "1.2",
    "incomeCurrency": "BTC",
    "commissionPercent": "0.002",
    "status": "FULLY_EXECUTED"
  }
],
"total": 1
}

---

Объект Order

Параметр	Тип	Описание
id	string	UUID ордера
currencyFrom	string	Базовая валюта
currencyTo	string	Котируемая валюта
orderType	string	Тип ордера
orderDirection	string	Направление ордера
avgExecutedPrice	string	Средняя цена исполнения
price	string	Цена ордера
executedAmount	string	Исполненное количество
amount	string	Общее количество
volume	string	Объем ордера
executedVolume	string	Исполненный объем
createdAt	string	Время создания
executedAt	string	Время исполнения
commission	string	Комиссия
incomeAmount	string	Сумма дохода
incomeCurrency	string	Валюта дохода
commissionPercent	string	Процент комиссии
status	string	Статус ордера

---

Статусы ордеров

• OPEN — Открыт
• FULLY_EXECUTED — Полностью исполнен
• CANCELED — Отменен

Error response

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