عندما تضيف مفتاح API لمنصة، فإن Freya تتحقق منه قبل الحفظ، وإذا كان هناك خلل ما، فإنها تخبرك بما ينبغي إصلاحه. يساعدك هذا الدليل على قراءة تلك النتيجة وإصلاحها. (إذا اتصل مفتاحك بنجاح لكن بوتًا توقف لاحقًا، فتلك مشكلة مختلفة، راجع لماذا توقف بوتي مؤقتًا أو نهائيًا؟.)
لخطوات الإعداد لأول مرة، ابدأ بـ كيفية ربط منصتك؛ أما هذا المقال فيتناول ما ينبغي فعله عندما يفشل ذلك الاتصال.
أهم النقاط
- عندما تضيف مفتاحًا، تتحقق Freya من أنه يتصل ويملك الأذونات الصحيحة قبل حفظه، وإذا فشل شيء ما فإن الخطأ يخبرك بما ينبغي إصلاحه.
- «مفتاح/سر API غير صالح» يعني عادةً زلة في النسخ واللصق أو مفتاحًا أُعيد إنشاؤه؛ أما أخطاء «IP» فتعني أن قيد IP الخاص بالمفتاح لا يطابق ما تحتاجه Freya.
- يجب أن يملك مفتاحك أذونات القراءة والتداول (وليس السحب أبدًا) وأن يكون مُفعَّلًا للسوق الصحيح، الفوري أو العقود الآجلة، ليطابق بوتك.
- مفاتيح OKX تتطلب عبارة مرور يجب أن تتطابق تمامًا؛ وبالنسبة لمفاتيح العقود الآجلة، تُهيّئ Freya حسابك تلقائيًا حتى يتمكن البوت من التداول بشكل صحيح.
- رسالة «فشل الاتصال» العامة كثيرًا ما تكون عطلًا لحظيًا في الشبكة أو المنصة، فما عليك سوى المحاولة من جديد.
عندما لا يتصل المفتاح
إضافة مفتاح ليست حفظًا أعمى؛ فـ Freya تتحقق من أن المفتاح يعمل ويملك الأذونات الصحيحة قبل تخزينه مشفرًا. إذا كان هناك خلل ما، فإن الخطأ يوجّهك مباشرةً إلى السبب، وهو عادةً المفتاح أو السر، أو قيد IP، أو إذن ناقص. تشرح الأقسام التالية كل خطأ وكيفية إصلاحه.
«مفتاح API غير صالح» أو «مفتاح السر غير صالح»
أكثر أخطاء الاتصال شيوعًا، وعادةً أبسطها:
- زلة في النسخ واللصق مثل مسافة زائدة أو حرف مفقود. أعِد نسخ كل من المفتاح والسر بعناية.
- يُعرض السر مرة واحدة فقط. تكشف المنصات مفتاح السر مرة واحدة عند إنشائه. وإذا لم تحفظه فلا يمكنك استرجاعه، فأنشئ مفتاحًا جديدًا.
- حُذف المفتاح أو أُعيد إنشاؤه على المنصة، فلم يعد مطابقًا.
الحل: أعِد إدخال المفتاح والسر تمامًا، أو أنشئ مفتاحًا جديدًا وحاول من جديد.
أخطاء قيد IP
تتصل Freya من خوادمها الخاصة، لذا فإن إعدادات IP الخاصة بالمفتاح مهمة. وهناك حالتان مختلفتان:
- «عنوان IP ليس في القائمة البيضاء» يعني أن مفتاحك مقيّد بعنوان IP، لكن عنوان خادم Freya ليس ضمن قائمته المسموح بها. شاشة إضافة مفتاح API تعرض لك عنوان (أو عناوين) IP الذي ينبغي إضافته (مع زر نسخ)، فأضفها إلى القائمة البيضاء للمفتاح على المنصة.
- «غير مقيّد» يعني أن مفتاحك بلا أي قيد IP على الإطلاق. من أجل سلامتك، تطلب منك Freya تفعيل قيد IP وإضافة العنوان الذي تعرضه، ثم المحاولة من جديد.
في كلتا الحالتين، الحل هو الفكرة نفسها: قيِّد المفتاح على عنوان IP الذي تعرضه Freya في النافذة.
أخطاء الأذونات
اتصل المفتاح، لكنه لا يستطيع فعل ما يحتاجه بوتك:
- القراءة معطَّلة فعِّل إذن القراءة والعرض على المفتاح.
- إذن التداول ناقص فعِّل التداول (الفوري و/أو العقود الآجلة، بما يطابق بوتك).
- عدم تطابق بين الفوري والعقود الآجلة فبوت العقود الآجلة يحتاج مفتاحًا مُفعَّلًا فيه تداول العقود الآجلة؛ وبوت الفوري يحتاج تداول الفوري. إذا أضفت مفتاحًا للفوري فقط لبوت عقود آجلة (أو العكس)، فإن Freya تنبّهك إلى ذلك. تأكد من أن السوق المُفعَّل للمفتاح يطابق البوت الذي تبنيه.
تذكّر: لا تحتاج Freya أبدًا سوى إذني القراءة والتداول، وليس السحب أبدًا. المفتاح الذي بلا إذن سحب هو تمامًا ما تريده.
أمور خاصة بكل منصة
- OKX تحتاج عبارة مرور. عند إنشاء مفتاح OKX، تحدد أنت عبارة مرور، فأدخل عبارة المرور نفسها في Freya تمامًا كما ضبطتها. عبارة المرور الخاطئة سبب شائع لفشل الاتصال بـ OKX.
- إعداد العقود الآجلة على OKX. يحتاج تداول العقود الآجلة على OKX نمط حساب محددًا، تُهيّئه لك Freya تلقائيًا، فلست بحاجة إلى ضبطه يدويًا.
- وضع التحوّط (العقود الآجلة). تستخدم Freya وضع التحوّط لحسابات العقود الآجلة. إذا كانت لديك مسبقًا مراكز مفتوحة باتجاه واحد تتعارض معه، فقد ترى تحذيرًا بدلًا من فشل، فالمفتاح يُحفظ رغم ذلك، ويمكن لبوتك التداول بمجرد إغلاق تلك المراكز القائمة.
- Binance و Bybit لا تستخدمان عبارة مرور، فلا يوجد حقل عبارة مرور لهما.
«فشل الاتصال» بلا سبب واضح
فشل الاتصال العام كثيرًا ما يكون ليس خطأك، بل عطلًا لحظيًا في الشبكة أو انشغالًا مؤقتًا للمنصة. انتظر لحظة وحاول من جديد. إذا استمر الفشل بعد عدة محاولات، فأعِد التحقق من المفتاح والسر وإعدادات IP المذكورة أعلاه.
ما زلت عالقًا؟ قائمة تحقق سريعة
- أعِد إنشاء المفتاح على المنصة بإذني القراءة والتداول فقط (وليس السحب أبدًا).
- قيّده على عنوان IP الذي تعرضه Freya في شاشة إضافة مفتاح API.
- طابِق السوق فمفتاح فوري لبوت فوري، ومفتاح عقود آجلة لبوت عقود آجلة.
- OKX: أدخل عبارة المرور الصحيحة تمامًا.
- ما زال يفشل؟ تواصل مع [email protected].
الأسئلة الشائعة
تقول Freya «مفتاح API غير صالح» لكنني متأكد أنني نسخته بشكل صحيح، فما الخطأ؟
عادةً تسلل حرف أو مسافة خفية إلى المفتاح أو السر، أو أُعيد إنشاء المفتاح أو حُذف على المنصة فلم يعد مطابقًا. أعِد نسخ كلا الحقلين بعناية، وتذكّر أن السر يُعرض مرة واحدة فقط عند الإنشاء، فإن لم يكن لديك فأنشئ مفتاحًا جديدًا.
ما الفرق بين «عنوان IP ليس في القائمة البيضاء» و«غير مقيّد»؟
«عنوان IP ليس في القائمة البيضاء» يعني أن مفتاحك مقيّد بعنوان IP لكن عنوان خادم Freya ليس مسموحًا به بعد، فأضف العنوان الذي تعرضه Freya إلى القائمة البيضاء للمفتاح. أما «غير مقيّد» فيعني أن المفتاح بلا أي قيد IP على الإطلاق؛ ومن أجل السلامة، تطلب منك Freya تفعيل قيد IP وإضافة عنوانها قبل الحفظ.
مفتاح OKX الخاص بي لا يتصل، فهل أحتاج عبارة المرور؟
نعم. لمفاتيح OKX عبارة مرور تحددها عند إنشاء المفتاح. يجب أن تدخل عبارة المرور نفسها تمامًا في Freya، فعبارة المرور الخاطئة أو الناقصة سبب شائع لفشل الاتصال بـ OKX. أما Binance و Bybit فلا تستخدمان واحدة.
تقول Freya إن مفتاحي لا يستطيع تنفيذ صفقات، فكيف أصلح ذلك؟
مفتاحك ليس مُفعَّلًا فيه التداول للسوق الذي يستخدمه بوتك. على المنصة، فعِّل إذن التداول، أي التداول الفوري لبوت فوري، والعقود الآجلة لبوت عقود آجلة، ثم أعِد الاتصال. تحتاج Freya إذني القراءة والتداول، وليس السحب أبدًا.
مفتاح العقود الآجلة يحتاج إعدادًا إضافيًا (نمط الحساب / وضع التحوّط)، فهل هذه مشكلة؟
لا. يحتاج تداول العقود الآجلة نمط حساب محددًا ووضع تحوّط، تُهيّئهما لك Freya تلقائيًا. وإذا كانت لديك مراكز قائمة باتجاه واحد، فقد ترى تحذير وضع التحوّط بدلًا من خطأ، فالمفتاح يُحفظ رغم ذلك، ويمكن لبوتك التداول بمجرد إغلاق تلك المراكز.
أضفت مفتاح فوري لكن بوت العقود الآجلة لا يستخدمه (أو العكس)، فلماذا؟
يكون المفتاح مُفعَّلًا لسوق محدد. بوت العقود الآجلة يحتاج مفتاحًا مُفعَّلًا فيه تداول العقود الآجلة، وبوت الفوري يحتاج التداول الفوري. إذا لم يتطابقا، فإن Freya تنبّهك. اربط مفتاحًا يطابق سوقه المُفعَّل البوت الذي تنشئه.
الاتصال «فشل» فحسب بلا سبب واضح، فهل السبب مني أم من المنصة؟
كثيرًا ما يكون عطلًا لحظيًا في الشبكة أو المنصة لا في إعداداتك. حاول من جديد بعد لحظة. وإذا استمر الفشل، فأعِد التحقق من المفتاح والسر بحثًا عن أخطاء نسخ، وتأكد من أن قيد IP يطابق العنوان الذي تعرضه Freya.