إفصاح الشراكة: يتضمن هذا المقال OKX رابط شريك. قد يحقق المشغّل إيرادات عند التسجيل أو التداول عبر هذا الرابط. قد تختلف مزايا المستخدمين بحسب الحساب والمنطقة ومستوى VIP والحملة، لذا يُرجى التحقق من الشروط الفعلية المطبقة في شاشة التسجيل وفي My Rewards.
خلاصة القول، مفتاح API في OKX هو وسيلة مصادقة تتيح للتطبيقات الخارجية أو روبوتات التداول قراءة معلومات حسابك أو تنفيذ الأوامر. عند إنشائه، اختر الحد الأدنى من الأذونات اللازمة للغرض، واربطه بعنوان IP ثابت موثوق، وتعامل مع Secret Key وPassphrase على أنهما معلومات سرية لا يمكن الاطلاع عليهما مرة أخرى. حتى من دون صلاحية السحب، قد تؤدي صلاحية Trade المسروقة إلى خسائر كبيرة، لذا احذف فورًا أي مفتاح لا تستخدمه.
مخاطر الأمان والتداول: مفتاح API ليس ميزة لتحقيق أرباح تلقائية. إذا كُشفت صلاحية Trade، فقد تتكبد الأصول خسائر بسبب أوامر بأسعار غير مواتية، أو رافعة مالية مفرطة، أو تداول متكرر، حتى من دون صلاحية السحب. تنطوي أوامر العقود الآجلة عبر API على مخاطر نقص الهامش والتصفية القسرية، كما أن تقييد IP والمصادقة الثنائية 2FA لا يزيلان تمامًا مخاطر منح الأذونات الخاطئة أو التطبيقات الخبيثة التابعة لجهات خارجية. قد تختلف المنتجات والأذونات والشاشات حسب المنطقة والحساب.
ما مفتاح API في OKX؟
مفتاح API في OKX هو بيانات اعتماد تتيح للبرنامج إرسال طلبات مصادق عليها إلى حساب OKX. ويتكون عادةً من مجموعة تضم API Key وSecret Key وPassphrase، ويجب أن تتطابق جميعها حتى تتم الموافقة على طلبات الاطلاع على بيانات الحساب الشخصي أو تنفيذ الأوامر. ومن مزاياه إمكانية إنشاء مفاتيح وأذونات منفصلة لكل غرض بدلًا من مشاركة كلمة المرور، لكن توسيع نطاق الأذونات يزيد أيضًا من حجم الأضرار المحتملة.
يوضح دليل المساعدة الرسمي أن مفاتيح API تُستخدم للاطلاع على معلومات الحساب وتنفيذ الأوامر تلقائيًا عبر التطبيقات والمنصات الخارجية. ومع ذلك، قد تختلف الوظائف المتاحة باختلاف نوع الحساب والحسابات الفرعية والمنطقة وأهلية استخدام المنتجات والشاشة الحالية؛ لذا اعتمد على الشاشة التي تظهر بعد تسجيل الدخول، وهي OKX، بدلًا من أسماء القوائم الواردة في هذا المقال.
الفرق بين أذونات Read وTrade وWithdraw
| الإذن | العمليات المتاحة · المخاطر الرئيسية · المبدأ الموصى به |
|---|---|
| Read | العمليات المتاحة: الاطلاع على بيانات الحساب المسموح بها، مثل الرصيد والأوامر والصفقات المفتوحة المخاطر الرئيسية: كشف معلومات حساسة عن الحساب، مثل الأصول المحتفظ بها واستراتيجيات التداول المبدأ الموصى به: امنح Read فقط للوحات المعلومات التي تحتاج إلى الاطلاع دون غيره |
| Trade | العمليات المتاحة: إرسال الأوامر وإلغاؤها، وتحويل الأموال داخليًا، وإعدادات الكتابة وغيرها من العمليات التي تسمح بها واجهة API المعنية المخاطر الرئيسية: تداول غير مصرح به، وزيادة الرافعة المالية، وتراكم الرسوم، والتصفية المبدأ الموصى به: لا تمنح هذا الإذن إلا للمفاتيح التي تحتاج فعلًا إلى التداول الآلي، وادرس استخدام حساب فرعي منفصل |
| Withdraw | العمليات المتاحة: السحب عبر API المخاطر الرئيسية: أعلى المخاطر، إذ يمكن نقل الأصول إلى عنوان خارجي المبدأ الموصى به: لا تمنحه لروبوت تداول عادي، وادرسه فقط عند وجود حاجة واضحة للعمل |
| Transfer وLoan وEarn وغيرها | العمليات المتاحة: التحويل بين الحسابات، والاقتراض والسداد، والاشتراك في Earn واسترداد الأموال وغيرها من الوظائف المعروضة المخاطر الرئيسية: تخصيص الأموال لغير أغراض التداول وتغيير حالة الديون والمنتجات المبدأ الموصى به: أعد مراجعة كل إذن يظهر فعليًا في الحساب على حدة |
حتى صلاحية القراءة فقط ليست خالية من المخاطر. فقد يُساء استخدام بيانات الرصيد وسجل الأوامر والصفقات المفتوحة عند تسريبها في عمليات التصيد الاحتيالي أو الهجمات الموجهة. وفي المقابل، لا يمكن الجزم بأن مفتاح Trade الذي أُوقفت عنه صلاحية Withdraw آمن. فقد يؤدي إرسال أوامر متكررة لزوج تداول منخفض السيولة أو زيادة الرافعة المالية للعقود الآجلة إلى خسائر كبيرة بمجرد التداول.
يوضح OKX قسم الأسئلة الشائعة عن API، الذي حُدّث في 28 سبتمبر 2026، تفاصيل أذونات Transfer وLoan وEarn، وينبه إلى أن هذه الأذونات الثلاثة قد تُفعّل تلقائيًا، وفقًا لهذا التحديث، للمفاتيح التي كانت صلاحية Trade مفعّلة فيها سابقًا. تقتصر Loan وEarn على الحسابات المؤهلة لاستخدام هذه الوظائف. تحقق مجددًا من الأذونات الفعلية للمفاتيح الموجودة في شاشة إدارة API الحالية. لا تفترض أن التحويل أو الاقتراض أو عمليات المنتجات غير ممكنة لمجرد أن التصنيف العام للأذونات في الوثائق التقنية لا يذكرها.
ما ينبغي تحديده قبل إنشاء مفتاح API
- الغرض: اكتب في جملة واحدة ما إذا كان الغرض هو الاطلاع على الرصيد، أو تشغيل روبوت تداول، أو استخدام برنامج خاص، أو أداة للضرائب والمحاسبة.
- نطاق الحساب: حدّد ما إذا كنت تحتاج إلى الحساب الرئيسي كاملًا أم يكفيك حساب فرعي منفصل الرصيد.
- الأذونات: اختر الحد الأدنى من الأذونات اللازمة للغرض.
- IP: تحقّق من عنوان IP عام ثابت وموثوق يستخدمه البرنامج. لا تخمّن عنوان IP مشتركًا أو مؤقتًا.
- مكان الحفظ: حدّد طريقة تمنع حفظ Key وSecret وPassphrase في الشيفرة أو لقطات الشاشة أو تطبيقات المراسلة أو المستودعات العامة.
- معايير الإلغاء: حدّد من سيحذف المفتاح ومتى، في حال انتهاء المشروع أو تغيير المسؤول أو ظهور أوامر مشبوهة أو اختراق جهاز.
قد يساعد الحساب الفرعي على فصل استراتيجية التداول عن الحساب بأكمله. لكنه ليس ضمانًا يمنع الخسائر، ويجب التحقق أيضًا من صلاحيات التحويل الداخلي وبنية الربط بالحساب الرئيسي. يمكنك الاطلاع على إعدادات الأمان العامة للحساب في دليل السلامة وأمان الحساب في OKX.
كيفية إنشاء مفتاح API في OKX
خطوات الإنشاء عبر الويب
- سجّل الدخول إلى OKX، ثم افتح Profile → API and connections أو قائمة API الظاهرة حاليًا في حسابك.
- اختر Create API key.
- أدخل اسمًا للمفتاح وتحقق من الحساب الرئيسي أو الحساب الفرعي الذي تريد ربطه.
- اختر الغرض من الاستخدام والأذونات اللازمة.
- إن أمكن، أضف عنوان IP الموثوق للبرنامج إلى قائمة السماح.
- أنشئ Passphrase جديدة واحفظها في أداة لإدارة الأسرار.
- أكمل مصادقة 2FA لحساب OKX.
- فور الإنشاء، احفظ API Key وSecret Key مرة واحدة فقط في مكان آمن محدد، ثم أغلق الشاشة.
خطوات الإنشاء عبر التطبيق
يعرض قسم الأسئلة الشائعة الرسمي عن API، الذي تم التحقق منه في 24 أكتوبر 2026، المسار التالي في التطبيق: OKX Menu → API → Create API key. قد تظهر قائمة API ضمن Tools أو قائمة فرعية أخرى، حسب إصدار التطبيق والمنطقة. إذا لم تظهر القائمة، فلا تبحث عن تطبيقات غير رسمية أو طرق التفافية؛ بل تحقّق لدى الدعم الرسمي من ناشر التطبيق وحالة تحديثه ومن إتاحة الوظيفة لحسابك.
قد تنطبق على بعض المناطق والحسابات متطلبات أهلية منفصلة أو حدود للأصول لإصدار API. إذا لم تظهر الوظيفة، فتحقّق من الإرشادات الرسمية الخاصة بحسابك الحالي ومن خدمة العملاء، ولا تُودع أموالًا دون حاجة أو تتحايل باستخدام منطقة أو هوية أخرى لإصدار API.
لا يعني قفل حقل Account في شاشة إنشاء مفتاح API بالضرورة وجود خطأ. فبحسب الأسئلة الشائعة الرسمية، قد يكون محددًا مسبقًا على Main account ومقفلًا في الحساب الرئيسي الذي لا يرتبط به أي حساب فرعي.
إعداد قائمة IP المسموح بها وPassphrase
توضح الأسئلة الشائعة الرسمية عن API لدى OKX أنه يمكن ربط ما يصل إلى 20 عنوان IP بمفتاح واحد، على أن تفصل بينها فواصل أو مسافات. يُعد تقييد IP إجراءً مهمًا يمنع استخدام المفتاح من شبكات غير مسموح بها، لكنه لا يعني أنه يمكن ترك Secret وPassphrase مكشوفين.
- تحقّق من عنوان IP العام الثابت الفعلي للخادم عبر شاشة فريق البنية التحتية.
- لا تفترض أن VPN شخصيًا أو عنوان IP منزليًا يتغير باستمرار هو عنوان ثابت.
- احذف فورًا عناوين IP للخوادم التي لم تعد تستخدمها.
- تحقّق مما إذا كان عنوان IP الذي يقدمه روبوت تابع لجهة خارجية يطابق وثائقها الرسمية، وذلك بمقارنة النطاق وقنوات الدعم.
- لا تُعد استخدام مفتاح API نفسه مع خدمات متعددة.
Passphrase ليست كلمة مرور تسجيل الدخول إلى OKX. إنها سلسلة منفصلة يحددها المستخدم عند إنشاء مفتاح API، وتوضح الأسئلة الشائعة الرسمية أنه لا يمكن استعادة Passphrase المنسية. إذا فقدتها، فعليك حذف المفتاح القديم وإنشاء مفتاح جديد. لا تكتب Secret Key وPassphrase مباشرةً في ملفات الشيفرة، ولا تحفظهما في ميزة الحفظ التلقائي بالمتصفح أو في لقطات الشاشة أو عبر البريد الإلكتروني.
شروط الحذف التلقائي بعد 14 يومًا من عدم النشاط
وفقًا لوثيقة أمان API V5 التي تم التحقق منها في 24 أكتوبر 2026، تنتهي صلاحية مفتاح API عادي عند تحقق الشروط التالية معًا: عدم ربطه بعنوان IP، وامتلاكه صلاحية Trade أو Withdraw، وعدم نشاطه لمدة 14 يومًا. وتشير الأسئلة الشائعة الرسمية إلى أن المفتاح يُحذف تلقائيًا في هذه الحالة. تُحتسب استدعاءات API الموثقة الخاصة بالرصيد وسجل الحساب والأوامر على أنها استخدام، لكن مجرد إرسال المفتاح مع طلبات أسعار السوق التي لا تتطلب مصادقة لا يُحتسب نشاطًا.
يُحتسب استخدام WebSocket عند تنفيذ تسجيل الدخول فقط، ولا ينبغي افتراض أن الاشتراكات أو الطلبات بعد تسجيل الدخول تُحدّث وقت الاستخدام. تذكر الوثائق الرسمية أن مفاتيح واجهة برمجة التطبيقات للتداول التجريبي مستثناة من قاعدة انتهاء الصلاحية هذه. تحقّق من الحالة وسجل الاستخدام في قائمة واجهات API الحالية ومركز الأمان.
لذلك، لا تفترض أن «المفتاح سيظل موجودًا لمجرد أنك أنشأته»، بل تحقّق من حالته في قائمة API ضمن Profile. وفي المقابل، لا تعتمد على الحذف التلقائي بدلًا من إدارة الأمان. إذا انتهى المشروع أو ساورك الشك في انكشاف المفتاح، فأبطله فورًا بنفسك ولا تنتظر 14 يومًا. وبالنسبة إلى شروط انتهاء صلاحية المفاتيح المخصصة للقراءة فقط أو المرتبطة بعنوان IP، فاعتمد أولًا على شاشة الحساب الحالية وأحدث الأسئلة الشائعة الرسمية.
أمثلة على الحد الأدنى من الصلاحيات عند ربط روبوت تداول
| حالة الاستخدام | الصلاحيات التي يُرجح الحاجة إليها · الصلاحيات التي لا تكون مطلوبة عادةً · ضوابط إضافية |
|---|---|
| لوحة معلومات الرصيد والأداء | الصلاحيات التي يُرجح الحاجة إليها: Read الصلاحيات التي لا تكون مطلوبة عادةً: Trade, Withdraw ضوابط إضافية: مفتاح مخصص، وعنوان IP موثوق، وإبطال دوري |
| روبوت أوامر السوق الفوري | الصلاحيات التي يُرجح الحاجة إليها: Read, Trade الصلاحيات التي لا تكون مطلوبة عادةً: Withdraw ضوابط إضافية: أزواج التداول وحدود الأوامر، وحساب فرعي منفصل |
| روبوت أوامر العقود الآجلة | الصلاحيات التي يُرجح الحاجة إليها: Read, Trade الصلاحيات التي لا تكون مطلوبة عادةً: Withdraw ضوابط إضافية: رافعة مالية منخفضة، والتحقق من نمطي الهامش المعزول والمتقاطع، وحد أقصى للخسارة |
| جمع السجلات الضريبية والمحاسبية | الصلاحيات التي يُرجح الحاجة إليها: Read الصلاحيات التي لا تكون مطلوبة عادةً: Trade, Withdraw ضوابط إضافية: تقييد فترة التصدير، ومراجعة أمن المزوّد |
| نظام سحب خاص | الصلاحيات التي يُرجح الحاجة إليها: لا تُراجع صلاحية Withdraw إلا عند الحاجة إليها لأغراض العمل الصلاحيات التي لا تكون مطلوبة عادةً: كل الصلاحيات غير المرتبطة بالغرض ضوابط إضافية: ضوابط العناوين والمبالغ، وحساب منفصل، وموافقات متعددة ومراقبة |
حتى عندما يعمل كود الأوامر على التداول الآلي للعقود الآجلة بشكل طبيعي، تظل مخاطر السوق قائمة. إذا لم تكن تفهم اتجاه المركز، ونمط الحساب، وطريقة الهامش، والرافعة المالية وسعر التصفية المتوقع، فتحقّق أولًا من دليل المبتدئين لتداول العقود الآجلة في OKX، واختبر تدفق الأوامر في بيئة تجريبية قبل استخدام أموال حقيقية.
حساب رسوم التداول عبر API
لا تختفي رسوم التداول عند تقديم الأوامر عبر API. تُطبّق الرسوم الحالية بحسب ما إذا كان تنفيذ الأمر بصفة Maker أو Taker، وبحسب منتج السوق الفوري أو العقود الآجلة، ومستوى VIP وشروط الحساب. ولأن التداول الآلي قد يتضمن عددًا كبيرًا من الأوامر، فمن السهل إغفال تراكم التكاليف، لذا ينبغي حساب الرسوم على نحو منفصل ضمن أرباح الاستراتيجية وخسائرها.
حساب افتراضي: إذا كانت القيمة الاسمية لتنفيذ أحد الاتجاهين 10000 USDT، وكان معدل الرسوم التوضيحي 0.05%، فإن 0.05% = 0.0005، وبالتالي تكون رسوم التداول لأحد الاتجاهين 10000 × 0.0005 = 5 USDT. وإذا افترضنا تنفيذ الدخول والخروج 100 مرة لكل منهما، بالقيمة والمعدل نفسيهما، فسيكون الإجمالي 5 × 2 × 100 = 1000 USDT.
يفترض ذلك تساوي القيم الاسمية والمعدلات في كلا الاتجاهين واحتساب الرسوم على أساس USDT، ولا يمثّل معدلًا فعليًا لـ OKX. ويُطبّق الحساب الفعلي معدل Maker/Taker الخاص بالحساب، ومبالغ التنفيذ الفعلية، وعملة الرسوم والتقريب. ولا تُحسب المشتقات باستخدام الهامش وحده، كما لا يشمل الإجمالي أعلاه رسوم التمويل أو الفارق السعري أو الانزلاق أو تكاليف السحب أو الحسومات أو أرباح التداول وخسائره.
مزايا رمز الإحالة وصلاحيات API أمران منفصلان. ينبغي التحقق من مزايا الرسوم المتاحة عند تطبيق الرمز OKDCC في الشاشة قبل التسجيل، وبعد التسجيل في My Rewards؛ إذ قد تختلف المزايا بحسب الحساب والمنطقة ومستوى VIP والحملة. للاطلاع على خطوات التحقق، راجع دليل رمز الإحالة OKDCC في OKX.
لماذا يجب فصل مفاتيح API التجريبية عن مفاتيح التداول الفعلي
توضح الأسئلة الشائعة الرسمية لواجهة API لدى OKX أن مفاتيح API المخصصة للتداول التجريبي تُنشأ عبر مسار منفصل عن مفاتيح التداول الفعلي. ولا تضمن الطلبات الناجحة في البيئة التجريبية التنفيذ أو السيولة أو الانزلاق السعري أو الأرباح والخسائر في حساب التداول الفعلي. استخدم مفتاحًا مخصصًا للبيئة التجريبية، وأضف الترويسة x-simulated-trading: 1 إلى كل طلب تجريبي. وإذا كنت تستخدم SDK، فاضبط إعدادات البيئة التجريبية فيه وفقًا للوثائق الرسمية أيضًا. قد تشترك بيئتا التداول الفعلي والتجريبي في مضيف REST، لذا لا تفترض أنهما البيئة نفسها لمجرد تطابق العنوان. تحقّق من المفتاح وترويسة الطلب وإعدادات SDK والموقع الذي سُجّل فيه الحساب معًا.
- استخدم أسماء مختلفة لمفاتيح البيئة التجريبية والتداول الفعلي.
- حدّد البيئة في سجل بدء البرنامج، من دون طباعة Secret.
- قبل التداول الفعلي، تحقّق مرتين من الحدود القصوى لكمية الأمر وزوج التداول ونمط الحساب والرافعة المالية، في الكود والحساب.
- لا تستخدم نتائج البيئة التجريبية للتنبؤ بالعائد الفعلي أو لضمان الأرباح.
يمكنك الاطلاع على تدفق الأوامر والقيود التدريبية لكل بيئة في إرشادات التداول التجريبي في OKX. لا تدعم البيئة التجريبية بعض الوظائف، مثل الإيداع والسحب، ولا تزيل احتمال الخسارة في التداول الفعلي.
الإخفاقات الشائعة وتسلسل خطوات التحقق
| العَرَض | العنصر الأول الذي ينبغي التحقق منه · الإجراء الآمن |
|---|---|
| فشل المصادقة | العنصر الأول الذي ينبغي التحقق منه: تركيبة API Key وSecret وPassphrase، وبيئة التداول الفعلي أو التجريبي الإجراء الآمن: لا تطبع القيم السرية في السجلات؛ طابق اسم المفتاح والبيئة فقط |
| رفض متعلق بعنوان IP | العنصر الأول الذي ينبغي التحقق منه: عنوان IP العام الفعلي للخادم وقائمة السماح الإجراء الآمن: لا ترفع القيود عشوائيًا؛ عدّل عناوين IP الخاصة بالبنية التحتية الرسمية فقط |
| صلاحيات غير كافية | العنصر الأول الذي ينبغي التحقق منه: الصلاحيات المحددة مثل Read وTrade والوظيفة المطلوبة الإجراء الآمن: لا تفعّل Withdraw وكل الصلاحيات بسبب خطأ واحد؛ أضف الصلاحيات المطلوبة فقط |
| اختفاء المفتاح من القائمة | العنصر الأول الذي ينبغي التحقق منه: عدم ربط عنوان IP، وصلاحيات التداول والسحب، والنشاط خلال آخر 14 يومًا الإجراء الآمن: لا تعاود إرسال بيانات الاعتماد الحالية؛ تحقّق من الشاشة الرسمية مما إذا كنت بحاجة إلى مفتاح جديد |
| خطأ في اتجاه الأمر | العنصر الأول الذي ينبغي التحقق منه: نمط الحساب والمعلمات الواردة في وثائق API الحالية، مثل posSide الإجراء الآمن: تحقّق من الإعدادات في البيئة التجريبية وبمبالغ صغيرة قبل إعادة المحاولة في التداول الفعلي |
| أخطاء المفاتيح أو البيئة، مثل 50101 و50119 | العنصر الأول الذي ينبغي التحقق منه: مفتاح البيئة التجريبية أو الفعلية وترويساته، وموقع تسجيل الحساب، ومضيف API الرسمي للمزوّد الإجراء الآمن: لا تتحايل باستخدام حساب في منطقة أخرى؛ تحقّق من الوثائق الرسمية والدعم الملائمين للحساب الحالي |
| انتهاء مهلة طلب الأمر، مثل 50004 | العنصر الأول الذي ينبغي التحقق منه: تحقّق من قبول الأمر أو تنفيذه فعليًا باستخدام معرّف الأمر أو معرّف أمر العميل وسجل الأوامر الإجراء الآمن: لا تفترض أن الأمر فشل ولا ترسله فورًا مرة أخرى مكررًا |
| أمر غير متوقع | العنصر الأول الذي ينبغي التحقق منه: الخدمة التي تستخدم المفتاح، والجلسات النشطة، والأوامر المفتوحة والمراكز الإجراء الآمن: أبطِل المفتاح وأوقف الروبوت، وتحقق فورًا من الأوامر والمراكز وأمان الحساب |
ليس من الآمن حل المشكلة بتفعيل كل الصلاحيات أو إلغاء قيود IP لمجرد إزالة رسالة الخطأ. تحقّق من معلمات الطلب ونمط الحساب في وثائق API الحالية OKX، وسجّل وقت الطلب الفاشل ونقطة النهاية ورمز الخطأ فقط. لا تنشر Key أو Secret أو Passphrase أو الاستجابة الكاملة للحساب في منتدى الدعم أو مستودع عام.
عند الاشتباه في تسرب مفتاح أو صدور أوامر غير معتادة
- احذف مفتاح API المعني أو أبطله فورًا.
- أوقف الروبوتات والعمليات الجارية على الخوادم المرتبطة.
- تحقّق من الأوامر المفتوحة والمراكز والتحويلات الداخلية وسجل السحب.
- افحص أجهزة تسجيل الدخول والجلسات وPasskey ومفاتيح API الأخرى التي لا تعرفها.
- أعِد مراجعة كلمة مرور تسجيل الدخول إلى OKX وحالة المصادقة الثنائية 2FA باستخدام جهاز آمن.
- أزل القيم السرية من المستودعات والسجلات وتطبيقات المراسلة التي انكشفت، ولا تُعِد استخدام المفاتيح التي نُشرت بالفعل.
- إذا احتجت إلى مفتاح جديد، فأنشئه بصلاحيات محدودة وPassphrase جديدة وعنوان IP موثوق، ثم أعد ربط الخدمات واحدة تلو الأخرى.
- إذا تأكدت خسارة أو معاملة غير مصرّح بها، فاحتفظ بالأدلة التي لا تتضمن قيمًا سرية، مثل معرّفات الأوامر وأوقاتها، وتواصل مع OKXالدعم الرسمي.
التحقق من حذف المفتاح وتنظيم الأوامر خطوتان منفصلتان. لا تفترض أن إبطال المفتاح يعني إلغاء جميع الأوامر المفتوحة أو إغلاق المراكز. تحقّق من الحالة الفعلية للأوامر والمراكز والتحويلات الداخلية عبر التطبيق أو الموقع الرسمي باستخدام جهاز موثوق، واتبع إجراءات إدارة الأوامر والدعم الرسمي المناسبة للموقف. ولا تضمن هذه الإجراءات استرداد الخسائر أو منع وقوع خسائر إضافية.
قائمة تحقق قبل الإصدار وبعده
- □ هل يمكنك شرح الغرض من المفتاح في جملة واحدة؟
- □ هل راجعت الأذونات التفصيلية الفعلية، مثل Read وTrade وWithdraw والأذونات المعروضة مثل Transfer وLoan وEarn؟
- □ هل عطّلت Withdraw في الروبوت الذي لا يحتاج إلى السحب؟
- □ هل ربطت عنوان IP ثابتًا وموثوقًا تستخدمه فعليًا؟
- □ هل امتنعت عن حفظ Secret وPassphrase في الشفرة أو لقطات الشاشة أو تطبيقات المراسلة؟
- □ هل ميّزت بين مفاتيح التداول التجريبي والفعلية، ورؤوس الطلبات، وبيئات SDK، والمواقع المسجّل فيها الحساب؟
- □ هل حدّدت كمية الطلبات، وأزواج التداول، والرافعة المالية، والحد الأقصى للخسارة؟
- □ هل تحذف بانتظام المفاتيح غير المستخدمة وعناوين IP القديمة؟
- □ هل أعددت تنبيهات للطلبات غير المعتادة وإجراءات إلغاء المفاتيح؟
- □ هل أدرجت الرسوم ورسوم التمويل في أرباح الاستراتيجية وخسائرها؟
الأسئلة الشائعة
هل أحتاج إلى مفتاح API إذا كنت أتداول فقط عبر تطبيق OKX أو موقعها المعتاد؟
لا. تُستخدم مفاتيح API لربط البرامج الخارجية والروبوتات وأدوات البيانات. وليست إعدادًا إلزاميًا للمستخدمين الذين يتداولون مباشرةً عبر تطبيق وموقع OKX العاديين.
هل يمكنني تقديم طلبات تداول باستخدام إذن Read فقط؟
لا. وفقًا للتقسيم الرسمي للأذونات، يلزم إذن Trade لتقديم الطلبات وإلغائها. ووفقًا لمبدأ الحد الأدنى من الامتيازات، لا تمنح إذن Trade للأدوات التي تحتاج فقط إلى الاطلاع على الأرصدة وسجل الطلبات.
هل يمكنني استعادة Secret Key أو Passphrase إذا نسيتهما؟
توضح الأسئلة الشائعة الرسمية أنه لا يمكن استعادة Passphrase. إذا لم تتمكن من تخزين Secret بأمان أو شككت في انكشافه، فمن الآمن إلغاء المفتاح الحالي وإنشاء مفتاح جديد.
هل تنتهي صلاحية جميع مفاتيح API الخاصة بـ OKX بعد 14 يومًا؟
لا. ينطبق ذلك عند اجتماع الشروط التالية: عدم ربط عنوان IP، وامتلاك إذن Trade أو Withdraw، وعدم النشاط لمدة 14 يومًا. ولا تُحتسب كنشاط، وفقًا للوثائق الرسمية، سوى الاستدعاءات التي تتطلب مصادقة وتسجيل الدخول إلى WebSocket. وتُستثنى مفاتيح التداول التجريبي من قاعدة انتهاء الصلاحية هذه، لذا تحقّق من الحالة الفعلية في قائمة API ومن أحدث الوثائق الرسمية.
هل يحتاج روبوت التداول حتمًا إلى إذن Withdraw؟
يعمل الروبوت الذي يقتصر عمله المعتاد على تنفيذ الطلبات غالبًا ضمن نطاقي Read وTrade. إذا طلبت خدمة خارجية إذن Withdraw، فلا توافق قبل التحقق من سبب الحاجة إليه، وكيفية التحكم بعناوين السحب ومبالغه.
هل يمكنني إعادة إرسال طلب تداول إذا انتهت مهلته؟
انتهاء المهلة وحده لا يؤكد فشل الطلب. يجب أولًا التحقق من حالة قبول الطلب وتنفيذه فعليًا، كما هو موضح في إرشادات 50004 ضمن الأسئلة الشائعة الرسمية لـ API. طابق معرّف الطلب أو معرّف طلب العميل مع سجل الطلبات الرسمي قبل اتخاذ أي إجراء، ولا ترسل الطلب نفسه مرة أخرى فورًا.
المصادر الرسمية وتاريخ المراجعة
- OKX: الأسئلة الشائعة حول الحسابات الفرعية، ووضع الحساب، واتصالات API — تأكد من ظهور تحديث بتاريخ 27 أغسطس 2026
- OKX الأسئلة الشائعة حول API — تأكد من ظهور تحديث بتاريخ 28 سبتمبر 2026
- OKX: كيف يمكنني تعزيز أمان تطبيق OKX؟ — تأكد من ظهور تحديث بتاريخ 22 سبتمبر 2026
- OKX الوثائق الرسمية لـ API V5 — للتحقق من معلمات الطلبات وأحدث نقاط النهاية
تاريخ المراجعة النهائية: 24 أكتوبر 2026. قد تتغير قائمة API والأذونات وقيود IP وحذف المفاتيح غير النشطة ووضع الحساب وشروط إتاحة المنتجات. اقرأ الحقائق الرسمية وأمثلة التشغيل الآمن من AKEYX كلًّا على حدة، وقبل تنفيذ أي إجراء فعلي، راجع شاشة الحساب بعد تسجيل الدخول وأحدث وثائق API الخاصة بـ OKX.