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

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

طلب

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

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

نوع المعلمة

string

تعريف

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

نوع المعلمة

string

تعريف

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

نوع المعلمة

string

تعريف

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

نوع المعلمة

string

تعريف

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

نوع المعلمة

string

تعريف

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

نوع المعلمة

string

تعريف

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

إجابة

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

اسمتعريف
idمعرف الطلب في كتاب الطلب
typeنوع الطلبالخيارات المتاحة:buysell
directionاتجاه الطلبالخيارات المتاحة:buysell
symbolالتصفية حسب زوج التداول (على سبيل المثال، `TRX_USDT`)
quantityالكمية المطلوبة من الأصل الأساسي
filledQuantityالكمية المملوءة من الأصول الأساسية
filledValueالكمية المملوءة من أصل عرض الأسعار
stateالحالة الحالية للطلب (على سبيل المثال، "مكتمل")
internalStateالحالة الداخلية للطلب (على سبيل المثال، "مملوء")
createdAtالوقت الذي تم فيه إنشاء الطلب
finishedAtالوقت الذي اكتمل فيه الطلب
stopLossPriceالحد الأدنى لسعر السوق للأصل، والذي عند الوصول إليه سيتم إلغاء الطلب تلقائيًا

تعريف

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

تعريف

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

تعريف

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

تعريف

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

تعريف

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

تعريف

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

تعريف

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

تعريف

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

تعريف

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

تعريف

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

تعريف

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

تعريف

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

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

اسمتعريف
idمعرف الصفقة
stateحالة التجارة (على سبيل المثال، "مكتمل")
createdAtالوقت الذي تم فيه إنشاء التجارة
completedAtالوقت الذي اكتملت فيه التجارة
averageFilledPriceمتوسط ​​سعر شغل للتجارة

تعريف

معرف الصفقة

تعريف

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

تعريف

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

تعريف

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

تعريف

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

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

اسمتعريف
idمعرف المعاملة
tradeRoleدور في التجارةالخيارات المتاحة:takermaker
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: خطأ داخلي في الخادم

مجموعات ممكنة

اسمتعريف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}
ينسخ