Аяқталған тапсырыстар тарихы
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}
Еліктеу