Історія виконаних замовлень

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

Визначення

Спеціальний параметр, що вказує кількість записів, які потрібно пропустити

Реакція

Параметри відповіді на замовлення

НазваВизначення
idID замовлення в книзі замовлень
typeТип замовленняДоступні варіанти:• buy• sell
directionНапрямок замовленняДоступні варіанти:• buy• sell
symbolФільтрувати за торговою парою (наприклад, `TRX_USDT`)
quantityЗапитувана кількість базового активу
filledQuantityЗаповнена кількість базового активу
filledValueЗаповнена кількість активу котирування
stateПоточний стан замовлення (наприклад, «виконано»)
internalStateВнутрішній стан замовлення (наприклад, «заповнено»)
createdAtЧас створення замовлення
finishedAtЧас виконання замовлення
stopLossPriceПорогова ринкова ціна активу, при досягненні якої ордер буде автоматично скасовано

Визначення

ID замовлення в книзі замовлень

Визначення

Тип замовленняДоступні варіанти:- buy- sell

Визначення

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

Визначення

Фільтрувати за торговою парою (наприклад, `TRX_USDT`)

Визначення

Запитувана кількість базового активу

Визначення

Заповнена кількість базового активу

Визначення

Заповнена кількість активу котирування

Визначення

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

Визначення

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

Визначення

Час створення замовлення

Визначення

Час виконання замовлення

Визначення

Порогова ринкова ціна активу, при досягненні якої ордер буде автоматично скасовано

Параметри відповіді на угоду

НазваВизначення
idІдентифікатор угоди
stateСтан торгівлі (наприклад, "завершено")
createdAtЧас створення торгівлі
completedAtЧас завершення торгівлі
averageFilledPriceСередня заповнена ціна угоди

Визначення

Ідентифікатор угоди

Визначення

Стан торгівлі (наприклад, "завершено")

Визначення

Час створення торгівлі

Визначення

Час завершення торгівлі

Визначення

Середня заповнена ціна угоди

Параметри відповіді на угоду

НазваВизначення
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}
Копіювати