Аяқталған тапсырыстар тарихы

get
https://api.cryptomus.com/v2/user-api/exchange/orders/history
Еліктеу

Өтініш

Сұрау параметрлері

ЕсімПараметр түріАнықтама
marketstringСауда жұбы бойынша сүзгілеу (мысалы, `TRX_USDT`)
directionstringБағыт бойынша сүзгілеуҚол жетімді опциялар:buysell
order_idstringТапсырыс кітабындағы тапсырыс идентификаторы бойынша сүзіңіз
client_order_idstringКлиент тапсырысының идентификаторы бойынша сүзгілеу
limitstringСұрау қайтарылатын жазбалардың максималды санын орнататын арнайы параметр
offsetstringӨткізіп жіберуге болатын жазбалар санын көрсететін арнайы параметр

Параметр түрі

string

Анықтама

Сауда жұбы бойынша сүзгілеу (мысалы, `TRX_USDT`)

Параметр түрі

string

Анықтама

Бағыт бойынша сүзгілеуҚол жетімді опциялар:- buy- sell

Параметр түрі

string

Анықтама

Тапсырыс кітабындағы тапсырыс идентификаторы бойынша сүзіңіз

Параметр түрі

string

Анықтама

Клиент тапсырысының идентификаторы бойынша сүзгілеу

Параметр түрі

string

Анықтама

Сұрау қайтарылатын жазбалардың максималды санын орнататын арнайы параметр

Параметр түрі

string

Анықтама

Өткізіп жіберуге болатын жазбалар санын көрсететін арнайы параметр

Жауап

Тапсырысқа жауап беру параметрлері

ЕсімАнықтама
idТапсырыс кітабындағы тапсырыс идентификаторы
typeТапсырыс түріҚол жетімді опциялар:buysell
directionТапсырыс бағытыҚол жетімді опциялар:buysell
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Саудадағы рөліҚол жетімді опциялар:takermaker
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}
Еліктеу