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