الأسئلة الشائعة لواجهة برمجة تطبيقات OKX
ماذا يعني مصطلح عبارة المرور؟
هذه هي كلمة المرور التي أدخلتها عند التقدم للحصول على مفتاح API. تحتاج إلى تذكرها بنفسك. بمجرد نسيانها، لا يمكنك استعادتها وسيتعين عليك إنشاء مفتاح API جديد.
كيف أنشئ مفتاح API؟
على التطبيق:
1. سجّل الدخول إلى حساب OKX الخاص بك > اختر القائمة (⋮⋮⋮) > مرّر للأسفل واختر مفتاح API > إنشاء مفتاح API
2. املأ اسم API > اختر الحساب و الغرض > أدخل القائمة البيضاء لعناوين IP > اختر الأذونات > أدخل العبارة التذكيرية
على الويب:
1. سجّل الدخول إلى حساب OKX الخاص بك > انتقل إلى الملف الشخصي واختر مفتاح API والاتصالات > إنشاء مفتاح API
2. املأ اسم مفتاح API > اختر الحساب و المستخدم لـ
3. أدخل القائمة البيضاء لعناوين IP > اختر الأذونات > أدخل العبارة السرية
ملاحظة:
تساعد عناوين IP في تأمين مفتاح API الخاص بك. يمكنك ربط ما يصل إلى 20 عنوانًا لكل مفتاح، مع فصلها بفاصلة أو بمسافة.
مطلوب منك عرض معلومات API والوصول إلى واجهته. يرجى الحفاظ على كلمة مرورك بأمان. يمكنك إنشاء API جديد إذا فقدت كلمة المرور، حيث لا يمكننا استعادة APIs.
كيف يمكنني إدارة أو تعديل مفتاح API؟
لإدارة أو تعديل مفتاح API الخاص بك على OKX:
سجّل الدخول إلى حساب OKX الخاص بك واذهب إلى الملف الشخصي > API.
سترى قائمة بمفاتيح API الخاصة بك الموجودة. انقر على المفتاح الذي تريد إدارته.
من هنا يمكنك:
عرض اسم مفتاح API، الأذونات، وقائمة عناوين IP المسموح بها المرتبطة.
حرر اسم المفتاح، الأذونات (قراءة، تداول، سحب)، أو عناوين IP المرتبطة.
احذف المفتاح إذا لم يعد هناك حاجة إليه.
ملاحظة: لا يمكنك عرض عبارة المرور بعد إنشائها لأول مرة. إذا فقدتها، ستحتاج إلى حذف المفتاح الحالي وإنشاء مفتاح جديد. احرص دائمًا على تخزين بيانات اعتمادك بأمان.
كيف أميز بين التداول الفوري والتداول بالهامش إذا كنت أتداول باستخدام API؟
قد يختلف التمييز بين التداول الفوري والتداول بالهامش عبر API حسب نوع حسابك وإعداداته. نوصي بالرجوع إلى توثيق OKX API للحصول على أكثر المعلمات دقة وحداثة التي تنطبق على إعداد حسابك.
إذا كنت بحاجة إلى مزيد من التوضيح، يرجى التواصل مع مُساعِد العملاء من OKX للحصول على إرشادات مخصصة.
كيف أنشئ مفتاح API لقرص تجريبي؟
للتداول على API قرص العرض التجريبي، تحتاج إلى إنشاء مفتاح API على قرص العرض التجريبي. اتبع الخطوات التالية:
سجّل الدخول إلى حساب OKX الخاص بك > تداول > التداول التجريبي > المركز الشخصي > إنشاء مفتاح API لحساب تجريبي > ابدأ التداول التجريبي
هل سينتهي صلاحية مفتاح API؟
مفاتيح API التي لا ترتبط بعنوان IP ولديها أذونات للمعاملات أو عمليات السحب سيتم حذفها تلقائيًا بعد 14 يومًا من عدم النشاط. لن تُعتبر مفاتيح API غير نشطة إذا تم استخدامها لاستدعاء واجهات خاصة أو متعلقة بالحساب تتطلب التحقُّق من الهوية، مثل عرض رصيد الحساب، بيانات الفوترة، أو تقديم الطلبات.
مفاتيح API للقراءة فقط المرتبطة بعنوان IP أو أذونات محددة فقط هي التي لن تنتهي صلاحيتها.
ما هي أذونات القرض، والربح، والتحويل؟
تحويل: يسمح للمفتاح بتحويل الأموال بين حساباتك. متاح لجميع الحسابات.
قرض: يسمح للمفتاح باقتراض، السداد، وإدارة القروض. يظهر فقط إذا كان حسابك مؤهلاً لهذه الميزة.
يربح: يسمح للمفتاح بالاشتراك في منتجات يربح واستردادها. يظهر فقط إذا كان حسابك يمتلك الأهلية المطلوبة لهذه الميزة.
إذا كان مفتاح API الخاص بك يحتوي سابقًا على أذونات التداول مفعلة، فسيتم تفعيل الأذونات الثلاثة تلقائيًا عند هذا التحديث. لا يلزم أي إعداد يدوي.
هل يمكن تقديم الطلبات بوحدات العملة عند تقديم الطلبات من خلال الواجهة؟
لا؛ بالنسبة لأوامر العقود، الواجهة الافتراضية تعرض الأوامر بعدد العقود. إذا كنت بحاجة إلى حساب التحويل بين عدد العقود والعملات الرقمية، يمكنك الرجوع إلى واجهة تحويل عدد العقود إلى العملة الرقمية هنا.
كيف تحصل على معدل التقلب للواجهة؟
لا يمكن للواجهة الحصول مباشرة على زيادة أو انخفاض السعر، ولكن يمكن حسابها من خلال صيغة حسابية.
نسبة ارتفاع وانخفاض قيمة سعر المعاملة الأخيرة مقارنة بسعر افتتاح خط K قبل 24 ساعة / 100% من سعر افتتاح خط K قبل 24 ساعة.
يمكن الحصول على بيانات الصيغة أعلاه من خلال واجهة السوق هنا.
ما سبب ظهور رسالة الخطأ "51000 Parameter posSide error" عند تقديم الطلب؟
تحتاج إلى التحقق أولاً من وضع الحساب؛ وضع الشراء والبيع/وضع الفتح والإغلاق، والذي يمكن الاطلاع عليه هنا للحصول على posMode.
ملاحظة:
في حالة فتح وإغلاق الصفقات ووضع الأوامر باستخدام وحدة Cont، يُطلب معلمة posSide، ويتم ملء (صفقة) طويلة أو فتح صفقة قصيرة.
إذا كان الوضع شراء وبيع، أو تم إجراء معاملة عملة رقمية أو معاملة مرفوعة تحت وضع الفتح والإغلاق، فإن posSide يدعم فقط الصافي أو عدم الإرسال.
أي واجهة يمكن استخدامها للحصول على القيمة الاسمية للوحدة Cont والكمية الدنيا للطلب؟
يمكنك استخدام الواجهة للحصول على معلومات أساسية عن منتجات التداول هنا.
القيمة الاسمية لوحدة Cont: ctVal، الحد الأدنى للكمية في الطلب: minSz.
ما هو تنسيق instId؟
يمكنك استخدام الواجهة مباشرة للحصول على المعلومات الأساسية لمنتجات التداول هنا.
كيف تضبط طلب وقف الخسارة وطلب "جني الأرباح"؟
إذا كان الطلب مرتبطًا بطلب "جني الأرباح" وطلب وقف الخسارة، يمكنك الرجوع إلى واجهة الطلب هنا.: معلمات مصفوفة attachAlgoOrds.
ومع ذلك، إذا كان طلب وقف الخسارة منفصلاً، يمكنك الرجوع إلى واجهة عمولة الاستراتيجية هنا.
لماذا يتم الإبلاغ عن خطأ عند تعيين سعر التفعيل لطلب "جني الأرباح" وطلب وقف الخسارة: 51046، 51047، 51048، 51049؟
قواعد تحديد سعر تفعيل وقف الخسارة/سعر تفعيل جني الأرباح – أثناء البيع، يكون سعر تفعيل جني الأرباح أكبر من سعر المعاملة الأخير، ويكون سعر تفعيل وقف الخسارة أقل من سعر المعاملة الأخير؛ أما أثناء الشراء، فيكون سعر تفعيل جني الأرباح أقل من سعر المعاملة الأخير، ويكون سعر تفعيل وقف الخسارة أكبر من سعر المعاملة الأخير.
ما معنى "خطأ في الواجهة: 50102 طلب الطابع الزمني منتهي الصلاحية"؟
يحدث هذا الخطأ عندما يكون الطابع الزمني منتهي الصلاحية. تحتاج إلى استدعاء واجهة وقت النظام هنا لمزامنة وقت جهازك المحلي مع وقت خادمنا. الحفاظ على فرق الوقت ضمن 30 ثانية يمكن أن يساعد في تجنب هذه المشكلة.
ملاحظة: الوقت في رأس الطلب هو بتوقيت UTC0. عند استدعاء واجهة وقت الخادم، يتم توفير الوقت بتوقيت UTC + 8.
ما معنى "خطأ في الواجهة: 50101 مفتاح API لا يتطابق مع البيئة الحالية"؟
يعود ذلك إلى عدم التوافق بين مفتاح API والبيئة الحالية. تتطلب مكالمات الحساب الحقيقي استخدام مفتاح API الخاص بالحساب الحقيقي، ويجب أن تكون قيمة معلمة x-simulated-trading في رأس الطلب 0. تتطلب مكالمات الحساب المحاكى استخدام مفتاح API الخاص بالحساب المحاكى، ويجب أن تكون قيمة معلمة x-simulated-trading في رأس الطلب 1.
ما معنى "خطأ في الواجهة: 51010 الطلب غير مدعوم في وضع الحساب الحالي"؟
هذا مرتبط بوضع الحساب الخاص بك. إذا كنت ترغب في وضع رافعة مالية أو عقد بعملة واحدة، يجب عليك التبديل إلى الأوضاع الثلاثة الأخرى باستثناء وضع التداول الفوري! يمكنك ضبط ذلك من خلال إعدادات الواجهة هنا، أو يمكنك ضبطه على الويب أو التطبيق.
ملاحظة: يجب تعيين الإعداد الأول في الصفحة أو التطبيق؛ خيار الإعدادات في القائمة الرئيسية لصفحة التداول - وضع الحساب.
ما معنى "خطأ في الواجهة: 51121 يجب أن تكون كمية الطلب مضاعفًا لحجم اللوت"؟
في واجهة برمجة التطبيقات، تكون طلبات الوحدات Cont بوحدات الأوراق ويجب أن تكون مضاعفًا للكمية الدنيا للطلب في زوج التداول. يمكن الحصول على الكمية الدنيا للطلب من خلال حقل minSz في واجهة المنتج هنا.
"خطأ في عملية السحب: 58207 عنوان السحب غير مدرج في القائمة البيضاء للإعفاء من التحقُّق"؛ لماذا لا تزال عملية التحقُّق من القائمة البيضاء تُظهر خطأً رغم إغلاقها في صفحة السحب؟
لسحب العملات باستخدام واجهة API، من الضروري إضافة عنوان السحب في الصفحة وتفعيل زر "غير مُحقق بواسطة فيزا". سواء كانت خاصية التحقق من القائمة البيضاء معطلة في الصفحة أم لا، فلن يؤثر ذلك على وظيفة الواجهة.
ما معنى "خطأ في الواجهة: 50004 انتهاء مهلة طلب نقطة النهاية API" (لا يعني أن الطلب تم بنجاح أو فشل، يرجى التحقق من نتيجة الطلب)؟
عادةً ما يكون رمز الخطأ 50004 ناتجًا عن ضغط زائد على الخادم. تُعدّ الثامنة، السادسة عشرة، والرابعة والعشرون صباحًا هي نقاط الوقت لجمع رسوم رأس المال يوميًا. في هذه الأوقات، يكون ضغط الخادم مرتفعًا. يُنصح بتوزيع المعاملات لتجنب التزاحم في هذه الأوقات. إذا تم الإبلاغ عن خطأ 50004 في أوقات أخرى، يمكن إعادة المحاولة لاحقًا. إذا تم تقديم طلب مع خطأ 50004، فهذا لا يعكس النتيجة الفعلية لطلب الواجهة. قد ينجح الطلب أو يفشل. يرجى الرجوع إلى النتيجة الفعلية.
ما هو خطأ "مفتاح API 50119 غير موجود"؟
يحدث هذا الخطأ عادةً عندما لا يتطابق نطاق حسابك مع منطقتك.
بالنسبة لمستخدمي EEA، يرجى تغيير اسم نطاق طلب API الخاص بك إلى eea.okx.com بدلاً من www.okx.com.
بالنسبة لـ المستخدمين في الولايات المتحدة، يرجى تغيير اسم نطاق طلب API الخاص بك إلى us.okx.com بدلاً من www.okx.com.
إذا كنت تستخدم برنامجًا تابعًا لجهة خارجية للاتصال بـ OKX وظهرت لك هذه الرسالة، يرجى التحقق مع مزود البرنامج إذا كان يدعم النطاقات الإقليمية. على سبيل المثال، يجب على مستخدمي المنطقة الاقتصادية الأوروبية الاتصال عبر eea.okx.com، وإلا سيفشل الطلب.
لماذا يظهر الخطأ "50110" عند الربط ببرنامج طرف ثالث؟
قد يحدث هذا الخطأ إذا كان نوع مفتاح API الحالي غير متوافق مع ربط برنامج طرف ثالث. حاول التقدم للحصول على نوع معاملة مفتاح API، دون ربط قائمة IP، ثم أعد توصيل برنامج الطرف الثالث.
كيف أحصل على أحدث سعر معاملة لزوج التداول معين؟
استخدم التفاصيل هنا للرموز وللرمز، استخدم هنا. تُستخدم واجهة الرموز للحصول على أحدث سعر معاملة لأزواج العملات دفعة واحدة، ويُستخدم الرمز للحصول على أحدث سعر معاملة لأزواج العملات الفردية.
مثال على معامل الاستجابة لآخر سعر للتداول في قسم الرموز
ما هي المتطلبات لإنشاء مفتاح API؟
يتطلب إنشاء مفتاح API رصيدًا أدنى من الأصول تحت الإدارة (AUM) بقيمة 100 USD.
مطلوب أن يكون إجمالي الأصول تحت الإدارة (AUM) أكبر من 100 USD (AUM > 100U) لإنشاء مفتاح API
بالنسبة للحسابات الرئيسية أو الحسابات الفرعية، يُسمح فقط للحسابات التي تمتلك أصولًا تحت الإدارة (AUM) تزيد عن 100U بإنشاء مفاتيح API
ملاحظة: هذا الشرط ينطبق فقط على المستخدمين في مناطق معينة
ملاحظة:
إذا كانت لديك أسئلة حول WebSocket أو مواضيع أخرى متعلقة بواجهة برمجة التطبيقات، فانقر على رابط المقالة وامسح كود QR الموجود في أسفل المقالة باستخدام تطبيق OKX للانضمام إلى المجموعة والتواصل مع أخصائي دعم واجهة برمجة التطبيقات لدينا.
كيفية المسح: في التطبيق، اضغط على القائمة > أيقونة المسح، ثم امسح كود QR.