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

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

Визначення

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

Реакція

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

НазваТип параметраВизначення
idstringID замовлення в книзі замовлень
typestringТип замовленняДоступні варіанти:• buy• sell
directionstringНапрямок замовленняДоступні варіанти:• buy• sell
symbolstringФільтрувати за торговою парою (наприклад, `TRX_USDT`)
quantitystring|nullЗапитувана кількість базового активу
filledQuantitystringЗаповнена кількість базового активу
filledValuestringЗаповнена кількість активу котирування
statestringПоточний стан замовлення (наприклад, «виконано»)
internalStatestringВнутрішній стан замовлення (наприклад, «заповнено»)
createdAtstringЧас створення замовлення
finishedAtstringЧас виконання замовлення
stopLossPricestring|nullПорогова ринкова ціна активу, при досягненні якої ордер буде автоматично скасовано

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

string

Визначення

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

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

string

Визначення

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

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

string

Визначення

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

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

string

Визначення

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

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

string|null

Визначення

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

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

string

Визначення

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

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

string

Визначення

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

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

string

Визначення

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

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

string

Визначення

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

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

string

Визначення

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

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

string

Визначення

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

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

string|null

Визначення

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

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

НазваТип параметраВизначення
idstringІдентифікатор угоди
statestringСтан торгівлі (наприклад, "завершено")
createdAtstringЧас створення торгівлі
completedAtstringЧас завершення торгівлі
averageFilledPricestringСередня заповнена ціна угоди

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

string

Визначення

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

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

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}
Копія