تاریخچه سفارشات تکمیل شده
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 | شناسه معامله |
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 | سفارش تا حدی پر شد و سپس توسط کاربر لغو شد | partally_filled |
canceled_by_stop_loss | سفارش تا حدی تکمیل شد و سپس به دلیل رسیدن بازار به قیمت stop_loss به طور خودکار لغو شد. | partally_filled |
تعریف
سفارش تکمیل و به طور کامل پر شده استتعریف
سفارش پر نشد و توسط کاربر لغو شدتعریف
سفارش تکمیل نشد و به دلیل رسیدن بازار به قیمت 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}
کپی