تاریخچه سفارشات تکمیل شده
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 | string | شناسه سفارش در دفترچه سفارش |
| type | string | نوع سفارشگزینه های موجود:• buy• sell |
| direction | string | جهت سفارشگزینه های موجود:• buy• sell |
| symbol | string | فیلتر براساس جفت معاملاتی (به عنوان مثال، «TRX_USDT») |
| quantity | string|null | مقدار درخواستی دارایی پایه |
| filledQuantity | string | مقدار پر شده دارایی پایه |
| filledValue | string | مقدار پر شده از دارایی نقل قول |
| state | string | وضعیت فعلی سفارش (به عنوان مثال، "تکمیل") |
| internalState | string | وضعیت داخلی سفارش (به عنوان مثال، "پر شده") |
| createdAt | string | زمان ایجاد سفارش |
| finishedAt | string | زمان تکمیل سفارش |
| stopLossPrice | string|null | آستانه قیمت بازار دارایی که پس از رسیدن به آن سفارش به طور خودکار لغو می شود |
نوع پارامتری
stringتعریف
شناسه سفارش در دفترچه سفارشنوع پارامتری
stringتعریف
نوع سفارشگزینه های موجود:- buy- sellنوع پارامتری
stringتعریف
جهت سفارشگزینه های موجود:- buy- sellنوع پارامتری
stringتعریف
فیلتر براساس جفت معاملاتی (به عنوان مثال، «TRX_USDT»)نوع پارامتری
string|nullتعریف
مقدار درخواستی دارایی پایهنوع پارامتری
stringتعریف
مقدار پر شده دارایی پایهنوع پارامتری
stringتعریف
مقدار پر شده از دارایی نقل قولنوع پارامتری
stringتعریف
وضعیت فعلی سفارش (به عنوان مثال، "تکمیل")نوع پارامتری
stringتعریف
وضعیت داخلی سفارش (به عنوان مثال، "پر شده")نوع پارامتری
stringتعریف
زمان ایجاد سفارشنوع پارامتری
stringتعریف
زمان تکمیل سفارشنوع پارامتری
string|nullتعریف
آستانه قیمت بازار دارایی که پس از رسیدن به آن سفارش به طور خودکار لغو می شود
پارامترهای پاسخ معامله
| نام | نوع پارامتری | تعریف |
|---|---|---|
| id | string | شناسه معامله |
| state | string | وضعیت تجاری (به عنوان مثال، "تکمیل شده") |
| createdAt | string | زمانی که تجارت ایجاد شد |
| completedAt | string | زمانی که معامله به پایان رسید |
| averageFilledPrice | string | میانگین قیمت پر شده برای معامله |
نوع پارامتری
stringتعریف
شناسه معاملهنوع پارامتری
stringتعریف
وضعیت تجاری (به عنوان مثال، "تکمیل شده")نوع پارامتری
stringتعریف
زمانی که تجارت ایجاد شدنوع پارامتری
stringتعریف
زمانی که معامله به پایان رسیدنوع پارامتری
stringتعریف
میانگین قیمت پر شده برای معامله
پارامترهای پاسخ معامله معامله
| نام | نوع پارامتری | تعریف |
|---|---|---|
| id | string | شناسه تراکنش |
| tradeRole | string | نقش در تجارتگزینه های موجود:• taker• maker |
| filledPrice | string | قیمت پر شده برای معامله |
| filledQuantity | string | مبلغ اجرا شده به ارز پایه |
| filledValue | string | مبلغ اجرا شده به ارز مظنه |
| fee | string | کارمزد تراکنش |
| feeCurrency | string | ارزی که کارمزد در آن محاسبه می شود |
| committedAt | string | زمان اجرای تراکنش |
نوع پارامتری
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 | سفارش تا حدی پر شد و سپس توسط کاربر لغو شد | 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}کپی کنید