الأسئلة الشائعة لواجهة برمجة تطبيقات 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 غير موجود"؟
يحدث هذا الخطأ عادةً عندما لا يتطابق نطاق حسابك مع منطقتك.
بالنسبة لـ المُستخدِمين في المنطقة الاقتصادية الأوروبية، يرجى تغيير اسم نطاق طلب 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 من الاتصال أو استمر في الانفصال؟
تأكد من أنك تستخدم عنوان WebSocket الصحيح لموقعك وخدمة API الخاصة بك. تحقق من إعدادات الشبكة، الوكيل، TLS، معلمات الاشتراك، نبضات Ping/Pong، ومنطق إعادة الاتصال. إذا استمرت المشكلة، قدم القناة، وقت الحدوث، رسالة الخطأ الكاملة، والسجلات المحجوبة.
كيف يجب أن أحل مشكلة رمز خطأ API أو معلمة طلب غير صالحة؟
ابحث عن رمز الخطأ في الوثائق الرسمية لواجهة برمجة التطبيقات لموقعك، ثم تحقَّق من نقطة النهاية، طريقة HTTP، معلمات الطلب، وضع الحساب، وقيود المنتج. إذا ظل السبب غير واضح، قدّم رمز الخطأ الكامل، sCode/sMsg، وقت الحدوث، والطلب والاستجابة مع إخفاء البيانات الحساسة.
لماذا فشل تقديم أو تعديل أو إلغاء طلبي عبر API؟
يرجى استخدام رسالة الخطأ ورمز الخطأ الذي تم إرجاعه من API لتحديد السبب المحدد. إذا لم تكن متأكدًا من معنى الخطأ، يرجى تقديم معلمات الطلب الكاملة وتفاصيل الخطأ حتى نتمكن من التحقيق بشكل أعمق.
ماذا يجب أن أفعل إذا بدت بيانات السوق أو الشموع اليابانية أو بيانات دفتر الطلبات غير صحيحة؟
تأكد من اسم القناة، وinstId، ومعلمات الاشتراك، وتكرار الطلب، وميّز بين بيانات اللقطة والتحديثات التدريجية. بالنسبة لدفتر الطلبات، تحقَّق أيضًا من معرفات التسلسل والطوابع الزمنية. إذا بدا أن البيانات مفقودة، فسجّل القناة، ونطاق الوقت، والاستجابة الخام المحجوبة.
لماذا تختلف أرصدة API أو الصفقات أو قيم الهامش عن الموقع الإلكتروني أو التطبيق؟
أولاً، فرّق بين حساب التداول وحساب التمويل، ثم تحقَّق من وضع الحساب، بُعد العملة، نقطة النهاية، ووقت تحديث البيانات. بالنسبة لحسابات الرصيد، الصفقة، والهامش، استخدم أحدث وثائق المنتج وAPI للموقع المعني.
ماذا يجب أن أفعل إذا فشل إيداع أو عملية سحب أو تحويل عبر API؟
تحقق من أذونات API، العملة، الشبكة، الحساب الوجهة، وأي متطلبات لدفتر العناوين أو القائمة البيضاء، ثم قم بحل المشكلة باستخدام رمز الخطأ المعاد. قد تتطلب قيود أمان الحساب أو الامتثال أو المخاطر مراجعة إضافية من الدعم للموقع المعني.
كيف أنشئ وأستخدم مفتاح API لحساب فرعي؟
أنشئ مفتاح API تحت الحساب الفرعي المقصود واستخدم أذونات ذلك الحساب الفرعي، وعبارة المرور، ونطاق الموقع. لا تخلط بين مفتاح API أو السر أو عبارة المرور الخاصة بالحساب الرئيسي والحساب الفرعي.
ماذا يجب أن أفعل بعد تجاوز حد معدل API؟
قلل معدل الطلبات وفقًا للحد المسموح به لنقطة النهاية المحددة، واستخدم قوائم الانتظار للطلبات، والتراجع الأسي، أو نقاط النهاية الدُفعية حيثما كان ذلك مناسبًا. نطاق وحصة تحديد المعدل يمكن أن تختلف حسب نقطة النهاية، لذا لا تفترض أن جميع نقاط النهاية تشترك في نفس الحصة.
أين يمكنني العثور على وثائق API، ومجموعات تطوير البرمجيات (SDKs)، وأمثلة على الشيفرة؟
يمكنك الرجوع إلى توثيق API (V5). نقل الحالة التمثيلية (REST) + مرجع WebSocket، سجل التغييرات، رموز الأخطاء، عينات الطلب/الاستجابة لكل نقطة نهاية. SDKs الرسمية (GitHub) — github.com/okxapi يمكن العثور على مثال الكود في SDK.
ما المعلومات التي يجب أن أقدمها إذا كان بإمكاني فقط القول "واجهة برمجة التطبيقات لا تعمل"؟
قدّم نقطة النهاية، طريقة HTTP، العملية المقصودة، رمز الخطأ الكامل أو الرسالة، وقت الحدوث، موقع الحساب، بيئة الشبكة، والطلب والاستجابة المحجوبين. لا ترسل أبدًا مفتاح API السري، عبارة المرور، رمز التحقُّق، أو التوقيع غير المحجوب.
ماذا يجب أن أفعل إذا كان لدي استفسار حول API؟ هل يمكنني التحدث مع دعم API؟
إذا كانت لديك أي أسئلة أخرى، نرحب بانضمامك إلى مجموعة دعم API الخاصة بنا:
ملاحظة:
إذا كانت لديك أسئلة حول WebSocket أو مواضيع أخرى متعلقة بواجهة برمجة التطبيقات، فانقر على رابط المقال وامسح كود QR الموجود في أسفل المقال باستخدام تطبيق OKX للانضمام إلى المجموعة والتواصل مع أخصائي دعم واجهة برمجة التطبيقات لدينا.
كيفية المسح: في التطبيق، اضغط على القائمة > أيقونة المسح، ثم امسح كود QR.