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