История выполненных заказов

get https://api.cryptomus.com/v2/user-api/exchange/orders/history Скопировать

Запрос

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

ИмяТип параметраОписание
marketstringФильтровать по торговой паре (например, TRX_USDT).
directionstringФильтровать по направлениюДоступные опции:• buy• sell
order_idstringФильтровать по идентификатору ордера в книге заказов
client_order_idstringФильтровать по идентификатору заказа клиента
limitstringСпециальный параметр, задающий максимальное количество записей, возвращаемых запросом.
offsetstringСпециальный параметр, указывающий количество пропущенных записей.

Тип параметра

string

Описание

Фильтровать по торговой паре (например, TRX_USDT).

Тип параметра

string

Описание

Фильтровать по направлениюДоступные опции:- buy- sell

Тип параметра

string

Описание

Фильтровать по идентификатору ордера в книге заказов

Тип параметра

string

Описание

Фильтровать по идентификатору заказа клиента

Тип параметра

string

Описание

Специальный параметр, задающий максимальное количество записей, возвращаемых запросом.

Тип параметра

string

Описание

Специальный параметр, указывающий количество пропущенных записей.

Ответ

Параметры ответа на заказ

ИмяТип параметраОписание
idstringИдентификатор заказа в книге заказов
typestringТип заказаДоступные опции:• buy• sell
directionstringНаправление заказаДоступные опции:• buy• sell
symbolstringФильтровать по торговой паре (например, TRX_USDT).
quantitystring|nullЗапрошенное количество базового актива
filledQuantitystringЗаполненное количество базового актива
filledValuestringЗаполненное количество актива котировки
statestringТекущее состояние заказа (например, «выполнено»).
internalStatestringВнутреннее состояние заказа (например, «выполнено»)
createdAtstringВремя создания заказа
finishedAtstringВремя выполнения заказа
stopLossPricestring|nullПороговая рыночная цена актива, при достижении которой ордер будет автоматически отменен.

Тип параметра

string

Описание

Идентификатор заказа в книге заказов

Тип параметра

string

Описание

Тип заказаДоступные опции:- buy- sell

Тип параметра

string

Описание

Направление заказаДоступные опции:- buy- sell

Тип параметра

string

Описание

Фильтровать по торговой паре (например, TRX_USDT).

Тип параметра

string|null

Описание

Запрошенное количество базового актива

Тип параметра

string

Описание

Заполненное количество базового актива

Тип параметра

string

Описание

Заполненное количество актива котировки

Тип параметра

string

Описание

Текущее состояние заказа (например, «выполнено»).

Тип параметра

string

Описание

Внутреннее состояние заказа (например, «выполнено»)

Тип параметра

string

Описание

Время создания заказа

Тип параметра

string

Описание

Время выполнения заказа

Тип параметра

string|null

Описание

Пороговая рыночная цена актива, при достижении которой ордер будет автоматически отменен.

Параметры ответа на сделку

ИмяТип параметраОписание
idstringID сделки
statestringСостояние сделки (например, «завершено»)
createdAtstringВремя создания сделки
completedAtstringВремя завершения сделки
averageFilledPricestringСредняя цена исполнения сделки

Тип параметра

string

Описание

ID сделки

Тип параметра

string

Описание

Состояние сделки (например, «завершено»)

Тип параметра

string

Описание

Время создания сделки

Тип параметра

string

Описание

Время завершения сделки

Тип параметра

string

Описание

Средняя цена исполнения сделки

Параметры ответа на сделку по транзакции

ИмяТип параметраОписание
idstringИдентификатор транзакции
tradeRolestringРоль в торговлеДоступные опции:• taker• maker
filledPricestringЗаполненная цена за транзакцию
filledQuantitystringИсполненная сумма в базовой валюте
filledValuestringИсполненная сумма в валюте котировки
feestringКомиссия за транзакцию
feeCurrencystringВалюта, в которой взимается комиссия
committedAtstringВремя выполнения транзакции

Тип параметра

string

Описание

Идентификатор транзакции

Тип параметра

string

Описание

Роль в торговлеДоступные опции:- taker- maker

Тип параметра

string

Описание

Заполненная цена за транзакцию

Тип параметра

string

Описание

Исполненная сумма в базовой валюте

Тип параметра

string

Описание

Исполненная сумма в валюте котировки

Тип параметра

string

Описание

Комиссия за транзакцию

Тип параметра

string

Описание

Валюта, в которой взимается комиссия

Тип параметра

string

Описание

Время выполнения транзакции

Пример ответа


1{
2    "result": [
3        {
4            "id": "01JEXAPY04JDFBVFC2D23BCKMK",
5            "type": "market",
6            "direction": "sell",
7            "symbol": "TRX_USDT",
8            "quantity": "67.5400000000000000",
9            "filledQuantity": "67.5400000000000000",
10            "filledValue": "20.0053480000000000",
11            "state": "completed",
12            "internalState": "filled",
13            "createdAt": "2024-12-12 11:40:19",
14            "finishedAt": "2024-12-12 11:40:21",
15            "deal": {
16                "id": "01JEXAPZ9C9TWENPFZJASZ1YD2",
17                "state": "completed",
18                "createdAt": "2024-12-12 11:40:21",
19                "completedAt": "2024-12-12 11:40:21",
20                "averageFilledPrice": "0.2962000000000000",
21                "transactions": [
22                    {
23                        "id": "01JEXAPZ9C9TWENPFZJASZ1YD3",
24                        "tradeRole": "taker",
25                        "filledPrice": "0.2962000000000000",
26                        "filledQuantity": "67.5400000000000000",
27                        "filledValue": "20.0053480000000000",
28                        "fee": "0.0000000000000000",
29                        "feeCurrency": "USDT",
30                        "committedAt": "2024-12-12 11:40:21"
31                    }
32                ]
33            }
34        },
35        {
36            "id": "01JEXAJDK51C453Z3395RTAY8Y",
37            "type": "market",
38            "direction": "buy",
39            "symbol": "TRX_USDT",
40            "value": "20.0000000000000000",
41            "filledQuantity": "67.5400000000000000",
42            "filledValue": "19.9985940000000000",
43            "state": "completed",
44            "internalState": "filled",
45            "createdAt": "2024-12-12 11:37:51",
46            "finishedAt": "2024-12-12 11:37:53",
47            "deal": {
48                "id": "01JEXAJF41RJ05Z220F2H01S9Z",
49                "state": "completed",
50                "createdAt": "2024-12-12 11:37:53",
51                "completedAt": "2024-12-12 11:37:53",
52                "averageFilledPrice": "0.2961000000000000",
53                "transactions": [
54                    {
55                        "id": "01JEXAJF4ADPPPVH3NVP2SFX0F",
56                        "tradeRole": "taker",
57                        "filledPrice": "0.2961000000000000",
58                        "filledQuantity": "67.5400000000000000",
59                        "filledValue": "19.9985940000000000",
60                        "fee": "0.0000000000000000",
61                        "feeCurrency": "TRX",
62                        "committedAt": "2024-12-12 11:37:53"
63                    }
64                ]
65            }
66        },
67        {
68            "id": "01JEXAFCCC5ZVJPZAAHHDKQBNG",
69            "type": "limit",
70            "direction": "sell",
71            "symbol": "TRX_USDT",
72            "price": "0.2964000000000000",
73            "quantity": "20.0000000000000000",
74            "value": "5.9280000000000000",
75            "filledQuantity": "20.0000000000000000",
76            "filledValue": "5.9280000000000000",
77            "state": "completed",
78            "internalState": "filled",
79            "createdAt": "2024-12-12 11:36:12",
80            "finishedAt": "2024-12-12 11:36:22",
81            "deal": {
82                "id": "01JEXAFP50QGFS8CGY2YRR5EDV",
83                "state": "completed",
84                "createdAt": "2024-12-12 11:36:22",
85                "completedAt": "2024-12-12 11:36:22",
86                "averageFilledPrice": "0.2964000000000000",
87                "transactions": [
88                    {
89                        "id": "01JEXAFP55H5XHF3SHRVCEQ1G9",
90                        "tradeRole": "taker",
91                        "filledPrice": "0.2964000000000000",
92                        "filledQuantity": "20.0000000000000000",
93                        "filledValue": "5.9280000000000000",
94                        "fee": "0.0000000000000000",
95                        "feeCurrency": "USDT",
96                        "committedAt": "2024-12-12 11:36:22"
97                    }
98                ]
99            }
100        }
101    ]
102}
103
Скопировать

Возможные коды

404: Пользователь или ресурс не найден.

422: Неверные входные данные

500: Внутренняя ошибка сервера.

Возможные комбинации

ИмяОписаниевнутреннее_состояние
completedЗаказ выполнен и полностью исполнензаполненный
canceledЗаказ не был выполнен и отменен пользователемпустой
canceled_by_stop_lossОрдер не был исполнен и был автоматически отменен из-за достижения рынком цены stop_lossпустой
canceledЗаказ был частично исполнен, а затем отменен пользователемчастично_заполнено
canceled_by_stop_lossОрдер был частично исполнен, а затем автоматически отменен из-за достижения рынком цены stop_lossчастично_заполнено

Описание

Заказ выполнен и полностью исполнен

Описание

Заказ не был выполнен и отменен пользователем

Описание

Ордер не был исполнен и был автоматически отменен из-за достижения рынком цены stop_loss

Описание

Заказ был частично исполнен, а затем отменен пользователем

Описание

Ордер был частично исполнен, а затем автоматически отменен из-за достижения рынком цены stop_loss

Возможные ошибки

примеры ответов:


1{
2  "state": 0,
3  "message": "Standard validation error"
4}
Скопировать

Пример ответа с ошибкой


1{
2  "code": 0,
3  "message": "Validation failed.",
4  "errors": [
5    {
6      "property": "direction",
7      "value": "sells",
8      "message": "The value you selected is not a valid choice."
9    }
10  ]
11}
Скопировать