تاريخ الطلبات المكتملة

get https://api.cryptomus.com/v2/user-api/exchange/orders/history ينسخ

طلب

معلمات الاستعلام

اسمنوع المعلمةتعريف
marketstringالتصفية حسب زوج التداول (على سبيل المثال، `TRX_USDT`)
directionstringتصفية حسب الاتجاهالخيارات المتاحة:• buy• sell
order_idstringالتصفية حسب معرف الطلب في دفتر الطلبات
client_order_idstringالتصفية حسب معرف طلب العميل
limitstringمعلمة خاصة تحدد الحد الأقصى لعدد السجلات التي سيرجعها الطلب
offsetstringمعلمة خاصة تشير إلى عدد السجلات المطلوب تخطيها

نوع المعلمة

string

تعريف

التصفية حسب زوج التداول (على سبيل المثال، `TRX_USDT`)

نوع المعلمة

string

تعريف

تصفية حسب الاتجاهالخيارات المتاحة:- buy- sell

نوع المعلمة

string

تعريف

التصفية حسب معرف الطلب في دفتر الطلبات

نوع المعلمة

string

تعريف

التصفية حسب معرف طلب العميل

نوع المعلمة

string

تعريف

معلمة خاصة تحدد الحد الأقصى لعدد السجلات التي سيرجعها الطلب

نوع المعلمة

string

تعريف

معلمة خاصة تشير إلى عدد السجلات المطلوب تخطيها

إجابة

معلمات استجابة الطلب

اسمنوع المعلمةتعريف
idstringمعرف الطلب في كتاب الطلب
typestringنوع الطلبالخيارات المتاحة:• buy• sell
directionstringاتجاه الطلبالخيارات المتاحة:• buy• sell
symbolstringالتصفية حسب زوج التداول (على سبيل المثال، `TRX_USDT`)
quantitystring|nullالكمية المطلوبة من الأصل الأساسي
filledQuantitystringالكمية المملوءة من الأصول الأساسية
filledValuestringالكمية المملوءة من أصل عرض الأسعار
statestringالحالة الحالية للطلب (على سبيل المثال، "مكتمل")
internalStatestringالحالة الداخلية للطلب (على سبيل المثال، "مملوء")
createdAtstringالوقت الذي تم فيه إنشاء الطلب
finishedAtstringالوقت الذي اكتمل فيه الطلب
stopLossPricestring|nullالحد الأدنى لسعر السوق للأصل، والذي عند الوصول إليه سيتم إلغاء الطلب تلقائيًا

نوع المعلمة

string

تعريف

معرف الطلب في كتاب الطلب

نوع المعلمة

string

تعريف

نوع الطلبالخيارات المتاحة:- buy- sell

نوع المعلمة

string

تعريف

اتجاه الطلبالخيارات المتاحة:- buy- sell

نوع المعلمة

string

تعريف

التصفية حسب زوج التداول (على سبيل المثال، `TRX_USDT`)

نوع المعلمة

string|null

تعريف

الكمية المطلوبة من الأصل الأساسي

نوع المعلمة

string

تعريف

الكمية المملوءة من الأصول الأساسية

نوع المعلمة

string

تعريف

الكمية المملوءة من أصل عرض الأسعار

نوع المعلمة

string

تعريف

الحالة الحالية للطلب (على سبيل المثال، "مكتمل")

نوع المعلمة

string

تعريف

الحالة الداخلية للطلب (على سبيل المثال، "مملوء")

نوع المعلمة

string

تعريف

الوقت الذي تم فيه إنشاء الطلب

نوع المعلمة

string

تعريف

الوقت الذي اكتمل فيه الطلب

نوع المعلمة

string|null

تعريف

الحد الأدنى لسعر السوق للأصل، والذي عند الوصول إليه سيتم إلغاء الطلب تلقائيًا

معلمات استجابة الصفقة

اسمنوع المعلمةتعريف
idstringمعرف الصفقة
statestringحالة التجارة (على سبيل المثال، "مكتمل")
createdAtstringالوقت الذي تم فيه إنشاء التجارة
completedAtstringالوقت الذي اكتملت فيه التجارة
averageFilledPricestringمتوسط ​​سعر شغل للتجارة

نوع المعلمة

string

تعريف

معرف الصفقة

نوع المعلمة

string

تعريف

حالة التجارة (على سبيل المثال، "مكتمل")

نوع المعلمة

string

تعريف

الوقت الذي تم فيه إنشاء التجارة

نوع المعلمة

string

تعريف

الوقت الذي اكتملت فيه التجارة

نوع المعلمة

string

تعريف

متوسط ​​سعر شغل للتجارة

معلمات الاستجابة لمعاملة الصفقة

اسمنوع المعلمةتعريف
idstringمعرف المعاملة
tradeRolestringدور في التجارةالخيارات المتاحة:• taker• maker
filledPricestringالسعر المملوء للمعاملة
filledQuantitystringالمبلغ المنفذ بالعملة الأساسية
filledValuestringالمبلغ المنفذ بعملة الاقتباس
feestringرسوم المعاملة
feeCurrencystringالعملة التي يتم بها تحصيل الرسوم
committedAtstringوقت تنفيذ الصفقة

نوع المعلمة

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}
ينسخ