تاريخ الطلبات المكتملة
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: خطأ داخلي في الخادم
مجموعات ممكنة
| اسم | تعريف | Internal_state |
|---|---|---|
| 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}ينسخ