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

get

https://api.cryptomus.com/v2/user-api/exchange/orders/history

копировать

Запрос

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

Имя	Тип параметра	Описание
market	string	Фильтровать по торговой паре (например, TRX_USDT).
direction	string	Фильтровать по направлениюДоступные опции:• buy• sell
order_id	string	Фильтровать по идентификатору ордера в книге заказов
client_order_id	string	Фильтровать по идентификатору заказа клиента
limit	string	Специальный параметр, задающий максимальное количество записей, возвращаемых запросом.
offset	string	Специальный параметр, указывающий количество пропущенных записей.

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

string

Описание

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

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

string

Описание

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

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

string

Описание

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

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

string

Описание

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

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

string

Описание

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

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

string

Описание

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

Ответ

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

Имя	Описание
id	Идентификатор заказа в книге заказов
type	Тип заказаДоступные опции:• buy• sell
direction	Направление заказаДоступные опции:• buy• sell
symbol	Фильтровать по торговой паре (например, TRX_USDT).
quantity	Запрошенное количество базового актива
filledQuantity	Заполненное количество базового актива
filledValue	Заполненное количество актива котировки
state	Текущее состояние заказа (например, «выполнено»).
internalState	Внутреннее состояние заказа (например, «выполнено»)
createdAt	Время создания заказа
finishedAt	Время выполнения заказа
stopLossPrice	Пороговая рыночная цена актива, при достижении которой ордер будет автоматически отменен.

: Описание
Идентификатор заказа в книге заказов
: Описание
Тип заказаДоступные опции:- buy- sell
: Описание
Направление заказаДоступные опции:- buy- sell
: Описание
Фильтровать по торговой паре (например, TRX_USDT).
: Описание
Запрошенное количество базового актива
: Описание
Заполненное количество базового актива
: Описание
Заполненное количество актива котировки
: Описание
Текущее состояние заказа (например, «выполнено»).
: Описание
Внутреннее состояние заказа (например, «выполнено»)
: Описание
Время создания заказа
: Описание
Время выполнения заказа
: Описание
Пороговая рыночная цена актива, при достижении которой ордер будет автоматически отменен.

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

Имя	Описание
id	ID сделки
state	Состояние сделки (например, «завершено»)
createdAt	Время создания сделки
completedAt	Время завершения сделки
averageFilledPrice	Средняя цена исполнения сделки

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

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

Имя	Описание
id	Идентификатор транзакции
tradeRole	Роль в торговлеДоступные опции:• taker• maker
filledPrice	Заполненная цена за транзакцию
filledQuantity	Исполненная сумма в базовой валюте
filledValue	Исполненная сумма в валюте котировки
fee	Комиссия за транзакцию
feeCurrency	Валюта, в которой взимается комиссия
committedAt	Время выполнения транзакции

: Описание
Идентификатор транзакции
: Описание
Роль в торговлеДоступные опции:- taker- maker
: Описание
Заполненная цена за транзакцию
: Описание
Исполненная сумма в базовой валюте
: Описание
Исполненная сумма в валюте котировки
: Описание
Комиссия за транзакцию
: Описание
Валюта, в которой взимается комиссия
: Описание
Время выполнения транзакции

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


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}

копировать