الأسئلة الشائعة حول واجهة برمجة التطبيقات (API) على OKX
ما المقصود بعبارة المرور؟
هذه هي كلمة المرور التي أدخلتها عند طلب مفتاح واجهة برمجة التطبيقات. يجب عليك تذكرها بنفسك. بمجرد نسيانها، لن تتمكن من استعادتها، وستحتاج إلى إنشاء مفتاح API جديد.
كيفية إنشاء مفتاح API للقرص التجريبي؟
للتداول على القرص التجريبي، يجب إنشاء مفتاح API على القرص التجريبي. اتبع الخطوات التالية:
سجّل الدخول إلى حساب OKX الخاص بك > التداول > التداول التجريبي > المركز الشخصي > إنشاء مفتاح APIKey للحساب التجريبي > بدء التداول التجريبي
هل ستنتهي صلاحية مفتاح API؟
سيتم حذف مفاتيح API غير المرتبطة بعنوان IP والتي تتمتع بأذونات إجراء المعاملات أو السحب تلقائيًا بعد 14 يومًا من عدم النشاط. لن تُعتبر مفاتيح API غير نشطة إذا تم استخدامها لاستدعاء واجهات خاصة أو متعلقة بالحساب تتطلب التحقق من الهوية، مثل عرض رصيد الحساب، أو بيانات الفواتير، أو وضع الطلبات.
لن تنتهي صلاحية مفاتيح API المخصصة للقراءة فقط والمرتبطة بعنوان IP أو أذونات محددة.
هل يمكن وضع الطلبات بوحدات العملة عند وضع الطلبات من خلال الواجهة؟
لا؛ بالنسبة لطلبات العقود، تُضبط الواجهة افتراضيًا على عدد العقود. إذا كنت بحاجة إلى حساب التحويل بين عدد العقود والعملات الرقمية، فيمكنك الرجوع إلى واجهة تحويل عدد العقود إلى العملات الرقمية هنا.
كيفية الحصول على معدل تقلب الواجهة؟
لا يمكن للواجهة الحصول مباشرة على ارتفاع السعر أو انخفاضه، ولكن يمكن حسابه من خلال معادلة حسابية.
قيمة الارتفاع والانخفاض لأحدث سعر معاملة مقارنةً بسعر افتتاح خط K قبل 24 ساعة ÷ 100% من سعر افتتاح خط K قبل 24 ساعة.
يمكن الحصول على بيانات الصيغة أعلاه من خلال واجهة السوق هنا (last-open24h)÷open24h
ما هو سبب ظهور رسالة الخطأ "51000 Parameter posSide error" عند تقديم الطلب؟
يجب عليك أولًا التحقق من وضع الحساب؛ يمكنك عرض وضع الشراء/البيع أو وضع الفتح/الإغلاق هنا للحصول على معلمة posMode.
ملاحظة:
في حالة فتح وإغلاق الصفقات وتقديم الطلبات باستخدام العقد، تكون معلمة posSide مطلوبة، ويتم تنفيذ الصفقات الطويلة أو القصيرة.
في حال تفعيل وضع الشراء والبيع، أو إذا أُجريت معاملة عملة رقمية أو معاملة رافعة مالية في وضع الفتح والإغلاق، فإن معلمة posSide تدعم فقط صافي التحويل أو عدم التحويل.
ما هي الواجهة التي يمكن استخدامها للحصول على القيمة الاسمية للعقد والحد الأدنى لكمية الطلب؟
يمكنك استخدام الواجهة للحصول على المعلومات الأساسية لمنتجات التداول هنا.
القيمة الاسمية للعقد: ctVal، والحد الأدنى لكمية الطلب: minSz.
ما هو تنسيق instId؟
يمكنك استخدام الواجهة مباشرة للحصول على المعلومات الأساسية لمنتجات التداول هنا.
كيفية ضبط طلب وقف الخسارة وطلب جني الأرباح؟
إذا كان الطلب مرفقًا لجني الأرباح ووقف الخسارة، فيمكنك الرجوع إلى واجهة الطلب هنا: معلمات مُجموعة AlgoOrds.
ومع ذلك، إذا كان الطلب منفصلًا لوقف الخسارة، يمكنك الرجوع إلى واجهة عمولة الاستراتيجية هنا.
لماذا تم الإبلاغ عن خطأ عند تعيين سعر التفعيل لطلب جني الأرباح ووقف الخسارة: 51046، و51047، و51048، و51049؟
قواعد تعيين سعر تفعيل وقف الخسارة/سعر تفعيل جني الأرباح – أثناء البيع، يكون سعر تفعيل جني الأرباح أكبر من أحدث سعر للمعاملة، وسعر تفعيل وقف الخسارة أقل من أحدث سعر للمعاملة؛ في حين أثناء الشراء، يكون سعر تفعيل جني الأرباح أقل من أحدث سعر للمعاملة، وسعر تفعيل وقف الخسارة أكبر من أحدث سعر للمعاملة.
ما هو "خطأ الواجهة: 50102 انتهت صلاحية طلب الطابع الزمني"؟
يحدث هذا الخطأ عندما تنتهي صلاحية الطابع الزمني. يجب عليك استدعاء واجهة وقت النظام هنا لمزامنة وقتك المحلي مع وقت الخادم لدينا. يُساعد الحفاظ على فارق التوقيت ضمن 30 ثانية على تجنب هذه المشكلة.
ملاحظة: الوقت في رأس الطلب هو بالتوقيت العالمي المنسق 0. عند استدعاء واجهة وقت الخادم، يتم توفير الوقت بالتوقيت العالمي المنسق + 8.
ما هو "خطأ الواجهة: 50101 APIKey لا يتطابق مع البيئة الحالية"؟
هذا بسبب عدم تطابق مفتاح API مع البيئة الحالية. تتطلب عمليات استدعاء الحساب الحقيقي استخدام مفتاح API الخاص بالحساب الحقيقي، ويجب أن تكون قيمة معلمة x- Simulated-trading في رأس الطلب 0. تتطلب عمليات استدعاء الحساب التجريبي استخدام مفتاح API الخاص بالحساب التجريبي، ويجب أن تكون قيمة معلمة x- Simulated-trading في رأس الطلب 1.
ما هو "خطأ الواجهة: 51010 الطلب غير مدعوم في وضع الحساب الحالي"؟
هذا يتعلق بوضع حسابك. إذا كنت تريد وضع رافعة مالية أو عقد من عملة واحدة، فأنت بحاجة إلى التكيف مع الأوضاع الثلاثة الأخرى باستثناء وضع التداول الفوري! يمكنك ضبطه من خلال إعدادات الواجهة هنا، أو يمكنك ضبطه على الويب أو التطبيق.
ملاحظة: يجب تعيين الإعداد الأول على الصفحة أو التطبيق؛ خيار الإعدادات في القائمة الرئيسية لصفحة التداول - وضع الحساب.
ما هو "خطأ الواجهة: 51121 يجب أن تكون كمية الطلب مضاعفًا لحجم الدفعة"؟
في واجهة برمجة التطبيقات (API)، تكون طلبات العقود في وحدات من الشرائح ويجب أن تكون مضاعفًا للحد الأدنى لكمية الطلب لزوج العملة. يمكن الحصول على الحد الأدنى لكمية الطلب من خلال حقل minSz في واجهة المنتج هنا.
"خطأ السحب: 58207 عنوان السحب غير مدرج في القائمة البيضاء للإعفاء من التحقق"؛ لماذا لا يزال التحقق من القائمة البيضاء يُبلغ عن خطأ عند إغلاقه في صفحة السحب؟
لسحب العملات باستخدام واجهة API، يجب إضافة عنوان السحب على الصفحة وتفعيل خيار "غير مُتحقق به من visa". لن يؤثر إيقاف التحقق من القائمة البيضاء على وظيفة الواجهة على الصفحة.
ما هو "خطأ في الواجهة: 50004 انتهت مهلة طلب نقطة نهاية واجهة برمجة التطبيقات" (لا يعني أن الطلب كان ناجحًا أو فاشلًا، يرجى التحقق من نتيجة الطلب)؟
عادةً ما يكون سبب الخطأ 50004 هو الضغط الزائد على الخادم. الساعة 8 صباحًا، 16 صباحًا، و24 صباحًا هي أوقات تحصيل رسوم رأس المال يوميًا. في هذا الوقت، يكون ضغط الخادم مرتفعًا. من المستحسن إجراء المعاملات في هذه الأوقات. في حال ظهور الخطأ 50004 في أوقات أخرى، يُمكن إعادة المحاولة لاحقًا. إذا تم تقديم طلب به خطأ 50004، فهذا لا يُمثل النتيجة الفعلية لطلب الواجهة. قد ينجح الطلب أو يفشل. يرجى الرجوع إلى النتيجة الفعلية.
ملحوظة: إذا كانت لديك أي أسئلة أخرى أو استفسارات أخرى متعلقة بواجهة برمجة التطبيقات (API)، فيمكنك التواصل معنا عن طريق مسح الرمز أدناه عبر التطبيق.
ما هو الخطأ "50119 مفتاح واجهة برمجة التطبيقات غير موجود"؟
يحدث هذا الخطأ عادةً عندما لا يتطابق نطاق حسابك مع منطقتك.
بالنسبة إلى مستخدمي المنطقة الاقتصادية الأوروبية، يُرجى تغيير اسم نطاق طلب واجهة برمجة التطبيقات الخاص بك إلى eea.okx.com بدلًا من www.okx.com.
بالنسبة إلى مستخدمي الولايات المتحدة، يُرجى تغيير اسم نطاق طلب واجهة برمجة التطبيقات الخاص بك إلى us.okx.com بدلًا من www.okx.com.
إذا كنت تستخدم برنامجًا تابعًا لطرف ثالث للاتصال بـ OKX ورأيت هذا الخطأ، فيرجى التحقق مع موفر البرنامج لمعرفة ما إذا كان يدعم المجالات الإقليمية. على سبيل المثال، يجب على مستخدمي المنطقة الاقتصادية الأوروبية الاتصال عبر eea.okx.com، وإلا قد يفشل الطلب.
لماذا يظهر الخطأ "50110" عند الارتباط ببرنامج تابع لطرف ثالث؟
قد يحدث هذا الخطأ إذا كان نوع مفتاح API الحالي غير متوافق مع ربط برامج الطرف الثالث. حاول التقدم بطلب للحصول على نوع معاملة مفتاح API، دون ربط قائمة IP، ثم إعادة توصيل برنامج الطرف الثالث.